错误码规范
1. 设计原则
- 业务错误与系统错误分层。
- 错误码稳定,便于前端映射文案和测试断言。
- 同一错误场景跨接口复用同一错误码。
2. 编码规则
0:成功4xxxx:客户端请求或业务前置条件错误5xxxx:服务端或基础设施错误
3. 核心错误码
| 错误码 | 含义 | 说明 |
|---|---|---|
| 0 | 成功 | 请求处理成功 |
| 40001 | 参数错误 | 请求参数校验失败 |
| 40101 | 未登录 | 缺少或无效会话 |
| 40301 | 无权限 | 角色无访问权限 |
| 40401 | 资源不存在 | 目标对象不存在 |
| 40901 | 状态冲突 | 当前对象状态不允许该操作 |
| 40911 | 提交次数超限 | 学员提交次数已达上限 |
| 40912 | 已过截止时间 | 任务已关闭或截止 |
| 50001 | 系统异常 | 未知服务端错误 |
| 50011 | 判题失败 | 判题任务执行异常 |
| 50012 | 对象存储异常 | 文件上传或读取失败 |
4. 前端处理建议
40101:跳转登录页。40301:显示无权限页或提示。409xx:提示用户当前业务冲突原因。500xx:显示统一系统异常提示,并保留requestId便于排查。