重构后端服务架构并优化前端错误处理

backend-java/RUN_INSTRUCTIONS.md

@@ -0,0 +1,103 @@
+# 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