错误码与国际化
统一响应壳、错误码号段、三语文案。
响应结构
{
"code": 0,
"message": "ok",
"traceId": "6b2f0c8e1a...",
"data": { }
}
- HTTP 状态恒为 200,业务结果看
code。 - 字段为 null 时不出现在 JSON 里,前端契约以此为准。
- 响应体只能由统一工具类产出,禁止
new ResponseResult<>()。
号段
| 号段 | 含义 |
|---|---|
0 | 成功 |
400001 | 参数与校验问题(含非法排序字段) |
401001 | 未登录 |
403001 | 无权限 |
500003 | 系统繁忙(兜底) |
提示:以代码中的错误码实现为准;新增错误码必须同步三语文案,缺一种语言构建即失败。
新增一个错误码
- 实现错误码接口,给出号段与默认文案。
- 在
i18n的三份文案文件里各补一条。 - 业务里抛业务异常,由全局异常处理器统一翻译成响应。
排查
用户报错时只要拿到响应里的 traceId,就能在日志里还原这次请求的完整链路。
最后更新 2026-10-09编辑此页 →