Become a sponsor
8.2 错误码对照表
概述
业务错误码定义在 utility/apperr，经 internal/consts 别名转出（internal 层只依赖 consts 一个入口）。对外信封除 401 外统一显示为 1，本表用于理解 msg 背后的原因分类。
通用码
| 码 | 常量 | 消息 |
|---|---|---|
| 1 | CodeFailed | 操作失败 |
| 400 | CodeParamError | 参数校验失败 |
| 401 | CodeUnauthorized | 登录已过期，请重新登录 |
| 403 | CodeForbidden | 没有该操作权限 |
| 429 | CodeTooManyRequests | 请求过于频繁，请稍后再试 |
| 500 | CodeServerError | 服务器内部错误 |
| 1009 | CodeRecordExists | 记录已存在 |
| 1010 | CodeRecordNotFound | 记录不存在 |
认证与账户
| 码 | 常量 | 消息 |
|---|---|---|
| 1001 | CodeUserNotFound | 用户不存在 |
| 1002 | CodeUserDisabled | 账号已被禁用 |
| 1003 | CodePasswordWrong | 密码错误 |
| 1004 | CodeCaptchaError | 验证码错误或已过期 |
| 1008 | CodeTokenInvalid | Token无效或已失效 |
| 1012 | CodeOldPwdWrong | 原密码错误 |
租户
| 码 | 常量 | 消息 |
|---|---|---|
| 1005 | CodeTenantExpired | 租户已过期 |
| 1006 | CodeTenantDisabled | 租户已禁用 |
| 1007 | CodeTenantUserLimit | 租户用户数已达上限 |
| 1013 | CodeTenantNotFound | 租户不存在 |
业务约束（删除守卫等）
| 码 | 常量 | 消息 | 场景 |
|---|---|---|---|
| 1011 | CodeHasChildren | 存在下级或关联记录，不能删除 | 树形删除守卫 |
| 1014 | CodeInUse | 记录已被引用，不能删除 | 引用删除守卫 |
| 1015 | CodeDemoMode | 演示环境，禁止操作! | demo 中间件命中 |
角色常量（非错误码）
| 常量 | 值 | 说明 |
|---|---|---|
| RoleCodeSuperAdmin | ROLE_SUPER_ADMIN | 超管角色编码（保留） |
| PermWildcard | 通配权限码 | 超管通配（保留） |
保留编码仅平台初始化数据可用，租户自建角色禁止采用（防同名提权；超管判定另有 IsPlatform 门控双重防线）。
新增错误码规约
- 定义在
utility/apperr（码值 + 中文默认消息） - 在
internal/consts/biz_err.go别名转出 - 编号段规划：1xxx 认证租户业务类 / 10xx 守卫类
- 业务侧经
consts.CodeXxx哨兵或apperr.Newf(consts.CodeXxx.Code(), "fmt", a...)上抛
对外语义提醒
前端能稳定分支的只有 0 / 1 / 401 三值；细分码用于服务端日志、排障与文档。前端如需细分处理，以 msg 关键字或后续扩展专用字段为准，不建议直接依赖内部码。