niumalll/backend-java/RUN_INSTRUCTIONS.md

Java 后端服务运行说明

环境要求

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

安装 Maven（如果尚未安装）

macOS

如果已安装 Homebrew：

brew install maven

如果没有安装 Homebrew，先安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后安装 Maven：

brew install maven

Windows

1. 访问 Maven 官网
2. 下载最新版本的 Maven
3. 解压到指定目录
4. 配置环境变量：
   • 添加 MAVEN_HOME 环境变量，指向 Maven 安装目录
   • 将 %MAVEN_HOME%\bin 添加到 PATH 环境变量

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install maven

构建和运行服务

1. 使用 Maven Wrapper（推荐）

首先初始化 Maven Wrapper：

cd backend-java
mvn -N io.takari:maven:wrapper

然后构建项目：

cd user-service
./mvnw clean compile

2. 直接使用 Maven

如果已安装 Maven：

cd backend-java/user-service
mvn clean compile
mvn spring-boot:run

3. 打包并运行

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