启动后端服务

确保已完成 MySQL 与 Redis 准备 和 配置 Admin 服务 后，即可启动后端。

首次构建

# 进入后端根目录
cd forge

# 全量构建（跳过测试加速）
mvn clean install -DskipTests

首次构建会下载所有依赖，可能需要几分钟。完成后你应该看到 BUILD SUCCESS。

启动 Admin 服务

# 方式一：Spring Boot Maven 插件
cd forge-server/forge-admin-server
mvn spring-boot:run

# 方式二：指定环境
mvn spring-boot:run -Dspring-boot.run.profiles=dev

服务默认运行在 http://localhost:8580。

启动 Flow 服务（可选）

如果使用工作流功能，需要启动独立的 Flow 服务：

cd forge-server/forge-flow
mvn spring-boot:run

Flow 服务默认运行在 http://localhost:8581。

验证启动日志

启动成功后，你应该看到类似以下日志：

Forge Admin 启动成功
服务端口: 8580
环境: dev
框架版本: Spring Boot 3.2.x

验证 API 是否可用

# 健康检查
curl http://localhost:8580/

# 登录获取 Token
curl -s -X POST http://localhost:8580/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"123456"}'

常见启动问题

问题	可能原因	解决方案
端口占用	8580 端口已被使用	修改 application-dev.yml 中的端口
数据库连接失败	MySQL 未启动或密码错误	检查 MySQL 状态和配置
Flyway 报错	数据库权限不足	确认数据库用户有建表权限
Maven 构建失败	依赖下载超时	配置 Maven 镜像或使用代理

下一步

继续 启动前端。