快速开始常见问题

本页只列症状。具体步骤在 故障排查中心。

症状	规范页
Port 8580 is already in use / Port 3000 is already in use	START-PORT-IN-USE
Communications link failure	START-DB-CONNECTION-FAILED
Access denied for user	START-DB-AUTH-FAILED
库不存在	START-DB-NOT-FOUND
Collation 混用 / Flyway 失败	START-DB-COLLATION-MIXED、START-FLYWAY-MIGRATION-FAILED
Unable to connect to Redis / Connection refused	START-REDIS-CONNECTION-FAILED

还没有 errorKey 的安装问题

Maven 构建失败

现象：Could not resolve dependencies / BUILD FAILURE。

1. java -version 必须是 17，见 版本兼容。
2. 配置 ~/.m2/settings.xml 镜像。
3. 不要一上来就删掉整个 ~/.m2/repository；先对失败构件重试。

Node.js / pnpm

现象：pnpm: command not found。

1. node -v ≥ 20。
2. npm install -g pnpm 后在 forge-admin-ui 执行 pnpm install。

网页空白

1. 后端 8580 先起来。
2. 浏览器 F12 看控制台和 Network。
3. 代理失败见 START-PORT-IN-USE。