Forge Admin

Appearance

🔒 升级 PRO

CORE-SYSTEM-UNEXPECTED ​

错误编号：CORE-SYSTEM-UNEXPECTED

Spec 规定：无法安全确认具体根因时回退为本编号，日志仍记录真实异常。Java Manifest 和运行时 errorKey 尚未落地。

适用版本 / 权益 ​

免费。本页不编造 1001～1303 这类源码里不存在的业务码。

典型报错关键词 ​

  • RespInfo 的 message 为 操作失败（RespInfo.error() 默认）
  • BusinessException 默认 业务处理异常，默认 code = 500
  • Bean creation exception 等启动期未识别异常

用户会看到什么 ​

HTTP JSON 目前是：

json
{
  "code": 500,
  "message": "操作失败",
  "data": null,
  "timestamp": 1787623200000
}

字段名是 message，不是 msg。errorKey / traceId / help 还没有进 RespInfo。

发生原因 ​

未迁移的业务异常、未捕获的运行时异常，或启动期 Bean 创建失败，且对不上首批 START-* 识别规则。

配置位置 ​

没有单一配置键。先对照日志里的异常类，再看是否其实是数据库、Redis、端口问题。

正确配置 ​

不要根据关键词在前端自己拼配置位置。等 Manifest 落地后，已识别错误会带 errorKey。

解决步骤 ​

  1. 看完整服务端堆栈，不要只看前端弹窗。
  2. 若能对上 collation / Flyway / Redis / 端口，改走对应规范页。
  3. BusinessException 的 code 是调用方传入的整数，默认 500，不是稳定 errorKey。
  4. 启动期 Bean creation exception：缺配置、依赖冲突、库未初始化都有可能，按最早的 caused-by 判断。

验证方法 ​

同一请求再次失败时，日志里应能看到同一异常类。修复根因后 code 回到 200，message 为 操作成功。

仍未解决时提供的安全信息 ​

  • 本错误编号（规划中）
  • 异常类名
  • 请求方法与去 Query 的路径
  • 不要贴生产堆栈里的连接串、Token、请求体

相关文档 ​