完成从Node.js/NestJS到Java Spring Boot的后端迁移,修复资源管理API错误。 **核心修复:** - 修复资源库API 500错误 - ResourceLibrary/ResourceItem实体与数据库表结构对齐 - 更新ID类型从Long改为String,匹配数据库varchar(32) - 修正字段映射(libraryType → type) **新增Java实体(7个):** - CoursePackage, CoursePackageCourse, TenantPackage - CourseLesson, LessonStep, LessonStepResource - Theme **新增API控制器(5个):** - AdminResourceController - 资源库管理 - AdminPackageController - 课程套餐管理 - AdminCourseLessonController - 课程环节管理 - AdminThemeController - 主题字典管理 - SchoolPackageController - 学校套餐管理 **新增服务层(5个):** - ResourceLibraryService, CoursePackageService, CourseLessonService - ThemeService, FileStorageService **文档更新:** - 新增 Java环境配置与启动指南.md - 新增 Java后端启动完整指南.md - 新增 数据库迁移指南.md - 更新 CHANGELOG.md 和开发日志 **前端修复:** - 解决package.json合并冲突 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
Java 后端启动指南
问题:本地缺少 Maven 构建工具
启动 Spring Boot 项目需要 Maven 或 Gradle。
方式 1:安装 Maven(推荐)
macOS 使用 Homebrew 安装:
# 1. 安装 Homebrew(如果没有)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装 Maven
brew install maven
# 3. 验证安装
mvn -version
# 4. 启动后端
cd /Users/retirado/Program/ccProgram_0312/reading-platform-java
mvn spring-boot:run
方式 2:使用 IntelliJ IDEA(最简单)
- 打开 IntelliJ IDEA
- 选择
File→Open - 选择目录:
/Users/retirado/Program/ccProgram_0312/reading-platform-java - 等待 Maven 依赖下载完成
- 找到
ReadingPlatformApplication.java主类 - 右键 →
Run 'ReadingPlatformApplication'
方式 3:使用 VS Code
- 安装
Spring Boot Extension Pack插件 - 打开 Java 项目目录
- 点击侧边栏的
SPRING BOOT DASHBOARD - 点击启动按钮
方式 4:下载 Maven 手动安装
如果无法使用 Homebrew,可以手动下载 Maven:
# 下载 Maven
wget https://downloads.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
# 解压
tar -xzf apache-maven-3.9.6-bin.tar.gz
# 设置环境变量
export PATH=$PATH:/path/to/apache-maven-3.9.6/bin
# 验证
mvn -version
启动成功后
访问以下地址验证服务:
日志输出位置
启动后,后端日志将显示在控制台。
问题排查
如果启动失败,检查:
- 数据库连接 - 确认能连接到 8.148.151.56:3306
- 端口占用 - 确保 8080 端口没有被占用
- JDK 版本 - 需要 JDK 17 或更高版本
检查 JDK:
java -version
推荐: 使用 IntelliJ IDEA 是最简单的方式,会自动下载所有依赖并启动项目。