kindergarten_java/docs/Java后端启动指南.md
Claude Opus 4.6 081fac9d97 feat: Java后端迁移完成 - 资源管理API修复与文档更新
完成从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>
2026-03-12 19:49:48 +08:00

2.0 KiB
Raw Permalink Blame History

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最简单

  1. 打开 IntelliJ IDEA
  2. 选择 FileOpen
  3. 选择目录:/Users/retirado/Program/ccProgram_0312/reading-platform-java
  4. 等待 Maven 依赖下载完成
  5. 找到 ReadingPlatformApplication.java 主类
  6. 右键 → Run 'ReadingPlatformApplication'

方式 3使用 VS Code

  1. 安装 Spring Boot Extension Pack 插件
  2. 打开 Java 项目目录
  3. 点击侧边栏的 SPRING BOOT DASHBOARD
  4. 点击启动按钮

方式 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

启动成功后

访问以下地址验证服务:


日志输出位置

启动后,后端日志将显示在控制台。


问题排查

如果启动失败,检查:

  1. 数据库连接 - 确认能连接到 8.148.151.56:3306
  2. 端口占用 - 确保 8080 端口没有被占用
  3. JDK 版本 - 需要 JDK 17 或更高版本

检查 JDK

java -version

推荐: 使用 IntelliJ IDEA 是最简单的方式,会自动下载所有依赖并启动项目。