103 lines
2.0 KiB
Markdown
103 lines
2.0 KiB
Markdown
|
# 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
|