kindergarten_java/docs/Java后端启动指南.md

# 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 是最简单的方式，会自动下载所有依赖并启动项目。