START-PORT-IN-USE
错误编号：START-PORT-IN-USE
适用版本 / 权益
免费。四个官方服务端口：
| 服务 | server.port 来源 | 端口 |
|---|---|---|
| Admin | forge-admin-server/.../application.yml | 8580 |
| Report | forge-report-server/.../application.yml | 8581 |
| Flow | forge-flow-server/.../application.yml | 8081 |
| App | forge-app-server/.../application.yml | 8583 |
8581 是 Report，不要写成 Flow。
典型报错关键词
Port 8580 was already in use（或 8581 / 8081 / 8583）java.net.BindException- 前端开发服务器
Port 3000 was already in use（同类现象，端口不是后端官方端口）
用户会看到什么
对应服务进程退出，Web 容器没起来。
发生原因
本机已有进程占用该端口，或两个 Forge 服务配成了同一个端口。
配置位置
| 类型 | 位置 | 键 |
|---|---|---|
| YAML | 各服务 application.yml | server.port |
| 前端 | 前端环境文件 | 开发服务器端口（常见 3000） |
正确配置
保持官方端口。改 Admin 时不要改成 8581 或 8081。
解决步骤
bash
# macOS / Linux
lsof -i :8580
lsof -i :8081
lsof -i :8581
lsof -i :8583结束占用进程，或只改当前服务的 server.port。不要用 kill -9 当唯一方案而不确认 PID。
前端 3000 被占时，改开发服务器端口，先确认后端 8580 已起来再代理。
验证方法
lsof 只看到你刚启动的那个 Java/Node 进程。浏览器或 curl 能打到对应端口。
仍未解决时提供的安全信息
- 本错误编号
- 哪个服务、哪个端口
lsof里占用进程的命令名（不要贴整机进程表）