# Java 后端服务运行说明

## 环境要求

1. JDK 17 或更高版本
2. Maven 3.8 或更高版本

## 安装 Maven（如果尚未安装）

### macOS

如果已安装 Homebrew：
```bash
brew install maven
```

如果没有安装 Homebrew，先安装 Homebrew：
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
然后安装 Maven：
```bash
brew install maven
```

### Windows

1. 访问 [Maven 官网](https://maven.apache.org/download.cgi)
2. 下载最新版本的 Maven
3. 解压到指定目录
4. 配置环境变量：
   - 添加 MAVEN_HOME 环境变量，指向 Maven 安装目录
   - 将 %MAVEN_HOME%\bin 添加到 PATH 环境变量

### Linux (Ubuntu/Debian)

```bash
sudo apt update
sudo apt install maven
```

## 构建和运行服务

### 1. 使用 Maven Wrapper（推荐）

首先初始化 Maven Wrapper：
```bash
cd backend-java
mvn -N io.takari:maven:wrapper
```

然后构建项目：
```bash
cd user-service
./mvnw clean compile
```

### 2. 直接使用 Maven

如果已安装 Maven：
```bash
cd backend-java/user-service
mvn clean compile
mvn spring-boot:run
```

### 3. 打包并运行

```bash
cd backend-java/user-service
mvn clean package
java -jar target/*.jar
```

## 服务访问

用户服务默认运行在 8081 端口：
- 健康检查: http://localhost:8081/actuator/health
- 用户 API: http://localhost:8081/api/users

## 数据库配置

服务会自动连接到配置文件中指定的 MySQL 数据库：
- 主机: 129.211.213.226
- 端口: 9527
- 数据库: jiebandata
- 用户名: root
- 密码: aiotAiot123!

确保网络可以访问该数据库服务器。

## 常见问题

1. **端口被占用**: 修改 `application.yml` 中的 `server.port` 配置
2. **数据库连接失败**: 检查网络连接和数据库配置
3. **依赖下载失败**: 配置 Maven 镜像源或检查网络连接

## 开发工具

推荐使用以下 IDE 进行开发：
- IntelliJ IDEA
- Eclipse with Spring Tools
- VS Code with Java extensions