Skip to content

错误码规范

1. 设计原则

  • 业务错误与系统错误分层。
  • 错误码稳定,便于前端映射文案和测试断言。
  • 同一错误场景跨接口复用同一错误码。

2. 编码规则

  • 0:成功
  • 4xxxx:客户端请求或业务前置条件错误
  • 5xxxx:服务端或基础设施错误

3. 核心错误码

错误码含义说明
0成功请求处理成功
40001参数错误请求参数校验失败
40101未登录缺少或无效会话
40301无权限角色无访问权限
40401资源不存在目标对象不存在
40901状态冲突当前对象状态不允许该操作
40911提交次数超限学员提交次数已达上限
40912已过截止时间任务已关闭或截止
50001系统异常未知服务端错误
50011判题失败判题任务执行异常
50012对象存储异常文件上传或读取失败

4. 前端处理建议

  • 40101:跳转登录页。
  • 40301:显示无权限页或提示。
  • 409xx:提示用户当前业务冲突原因。
  • 500xx:显示统一系统异常提示,并保留 requestId 便于排查。