更多

错误码与国际化

统一响应壳、错误码号段、三语文案。

响应结构

{
  "code": 0,
  "message": "ok",
  "traceId": "6b2f0c8e1a...",
  "data": { }
}
  • HTTP 状态恒为 200,业务结果看 code。
  • 字段为 null 时不出现在 JSON 里,前端契约以此为准。
  • 响应体只能由统一工具类产出,禁止 new ResponseResult<>()。

号段

号段含义
0成功
400001参数与校验问题(含非法排序字段)
401001未登录
403001无权限
500003系统繁忙(兜底)

提示:以代码中的错误码实现为准;新增错误码必须同步三语文案,缺一种语言构建即失败。

新增一个错误码

  1. 实现错误码接口,给出号段与默认文案。
  2. 在 i18n 的三份文案文件里各补一条。
  3. 业务里抛业务异常,由全局异常处理器统一翻译成响应。

排查

用户报错时只要拿到响应里的 traceId,就能在日志里还原这次请求的完整链路。

最后更新 2026-10-09编辑此页 →