081fac9d97
完成从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>
100 lines
2.0 KiB
Markdown
100 lines
2.0 KiB
Markdown
# Java 后端启动指南
|
||
|
||
## 问题：本地缺少 Maven 构建工具
|
||
|
||
启动 Spring Boot 项目需要 Maven 或 Gradle。
|
||
|
||
---
|
||
|
||
## 方式 1：安装 Maven（推荐）
|
||
|
||
### macOS 使用 Homebrew 安装：
|
||
|
||
```bash
|
||
# 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. 选择 `File` → `Open`
|
||
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：
|
||
|
||
```bash
|
||
# 下载 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
|
||
```
|
||
|
||
---
|
||
|
||
## 启动成功后
|
||
|
||
访问以下地址验证服务：
|
||
|
||
- **API 文档**: http://localhost:8080/swagger-ui.html
|
||
- **健康检查**: http://localhost:8080/actuator/health
|
||
|
||
---
|
||
|
||
## 日志输出位置
|
||
|
||
启动后，后端日志将显示在控制台。
|
||
|
||
---
|
||
|
||
## 问题排查
|
||
|
||
如果启动失败，检查：
|
||
1. **数据库连接** - 确认能连接到 8.148.151.56:3306
|
||
2. **端口占用** - 确保 8080 端口没有被占用
|
||
3. **JDK 版本** - 需要 JDK 17 或更高版本
|
||
|
||
检查 JDK：
|
||
```bash
|
||
java -version
|
||
```
|
||
|
||
---
|
||
|
||
**推荐**: 使用 IntelliJ IDEA 是最简单的方式，会自动下载所有依赖并启动项目。
|