Forge Admin

Appearance

🔒 升级 PRO

启动后端服务 ​

确保已完成 MySQL 与 Redis 准备、初始化数据库和配置 Admin 服务后，即可启动后端。以下命令均从项目根目录开始执行。

构建并启动 ​

前置：MySQL / Redis 已就绪，且已完成 初始化数据库 和 配置 Admin。

bash
cd forge-server
mvn clean install -DskipTests

启动 Admin：

bash
cd forge-server/forge-admin-server
mvn spring-boot:run

Admin 运行在 http://localhost:8580。日志出现 Started ForgeAdminApplication 且没有数据源 / Redis / Flyway 错误即视为成功。

可选启动 Flow（工作流需要）：

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

Flow 官方端口是 8081，不是 Report 的 8581。

首次构建会下载依赖，完成后应看到 BUILD SUCCESS。也可以用 mvn spring-boot:run -Dspring-boot.run.profiles=dev 明确指定 dev 环境。

服务官方启动端口说明
Admin8580forge-admin-server 活动 application.yml
Report8581forge-report-server 活动 application.yml
Flow8081forge-flow-server 活动 application.yml
App8583forge-app-server 活动 application.yml
前端开发3000Vite 开发服务器

FlowClientProperties 类内默认 URL 是 http://localhost:8080。Admin 官方配置覆盖为 http://127.0.0.1:8081。文档和启动清单一律使用官方启动端口 8081，不要把 Report 的 8581 写成 Flow。

验证启动日志 ​

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

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

验证 API 是否可用 ​

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

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

常见启动问题 ​

步骤只在故障中心规范页：

问题规范页
端口占用START-PORT-IN-USE
数据库连接 / 认证 / 库不存在START-DB-CONNECTION-FAILED
Flyway / collationSTART-FLYWAY-MIGRATION-FAILED
Maven快速开始常见问题

下一步 ​

继续 启动前端。

相关文档 ​