总览 / 错误码字典
错误码字典
来自源码常量类 ResCode.java（业务码）与 chaos/ChaosRes.java（框架码），
不是人工整理的表格。「被多少接口抛出」由调用链遍历方法体里的 ResCode.X.toException(...) 得出，
接口卡片上也会列出该接口可能返回的业务码。
46错误码总数
26业务码 ResCode
20框架码 ChaosRes
26被接口显式抛出
1码值被多义复用
1. 前端怎么判断成功/失败
外层包装固定 {errcode, errmsg, data}（前端另兼容 code/msg/data）：
errcode=0 或 code=200 为成功；30002（会话已失效）与 HTTP 401 触发重新登录；
其余码值直接把 errmsg 弹给用户。详见调用手册。
⚠ 码值复用问题
同一个 code 对应多条不同业务含义，前端只能靠 errmsg 文案区分。建议为每个含义分配独立码值。
| 码值 | 被这些常量复用 | 各自提示语 |
|---|---|---|
20010 | CARD_RESOURCE_RULE_COUNT_ERROR、CARD_RESOURCE_RULE_MONTH_COUNT_ERROR、CARD_RESOURCE_RULE_DAY_COUNT_ERROR | 该旅游卡当天已经进行了核销，无需重复核销；该旅游卡本月在本景区无可用次数；该权益次数已用完，不可再预约哦！ |
2. 全表（46 条）
| 码值 | 提示信息 | 常量名 | 类型 | 涉及业务域 | 被多少接口抛出 | 代表接口 |
|---|---|---|---|---|---|---|
200 | 0 | SUCCESS | 框架 | — | 1 | /cqy/syncCqyRecord |
30002 | 会话已失效 | SESSION_AUTH_FAIL | 框架 | — | 0 | — |
30004 | MVC校验失败 | MVC_VALIDATE_FAIL | 框架 | — | 0 | — |
30005 | MVC注入未获取到值 | MVC_INJECT_NULL | 框架 | — | 0 | — |
30006 | MVC注入值失败 | MVC_INJECT_FAIL | 框架 | — | 0 | — |
30007 | 请求上下文异常 | CONTEXT_ERROR | 框架 | — | 0 | — |
30009 | 未设置请求路由 | ROUTE_CHANNEL_LOST | 框架 | — | 0 | — |
40004 | 您访问的接口地址不存在 | URL_NOT_FOUND | 框架 | — | 0 | — |
90000 | 请求参数转换失败 | PARAM_PARSE_FAIL | 框架 | — | 0 | — |
90001 | 缺少请求参数 | PARAM_NULL | 框架 | — | 0 | — |
90002 | 请求参数不合法 | PARAM_ERROR | 框架 | — | 6 | /card/bindBatchPreview |
90003 | 对象转换错误 | BEAN_MAP_FAIL | 框架 | — | 0 | — |
90101 | 本地缓存获取失败：Key不能为空 | LOCAL_CACHE_KEY_NULL | 框架 | — | 0 | — |
90102 | 本地缓存获取失败 | LOCAL_CACHE_GET_FAIL | 框架 | — | 0 | — |
90103 | 服务缓存获取失败 | SERVICE_CACHE_GET_FAIL | 框架 | — | 0 | — |
90104 | 分布式锁获取失败 | DISTRIBUTED_LOCK_GET_FAIL | 框架 | — | 0 | — |
90201 | 服务调用异常 | SERVICE_ERROR | 框架 | — | 22 | /ssk/user/logon |
90901 | 数据库错误 | DB_ERROR | 框架 | — | 0 | — |
90951 | 数据迁移失败 | DB_MIGRATE_FAIL | 框架 | — | 0 | — |
99999 | 服务内部错误 | SYS_FAIL | 框架 | — | 294 | /promotion/couponTemplate/addPromotionCouponTemplate |
10001 | 文件上传失败 | OSS_UPLOAD_ERROR | 业务 | — | 8 | /checker/faceConsumeCztk |
10002 | 文件下载失败 | FILE_DOWNLOAD_ERROR | 业务 | — | 1 | /oss/download |
10003 | 验证码为空 | VERIFY_CODE_IS_NULL | 业务 | — | 0 | — |
10004 | 验证码错误 | VERIFY_CODE_ERROR | 业务 | — | 3 | /cardBind/addCardBind |
10005 | 微信网页鉴权错误 | WEIXIN_OAUTH_ERROR | 业务 | — | 2 | /auth/oauth2session |
10006 | 小程序授权错误 | MP_OAUTH_ERROR | 业务 | — | 1 | /auth/oauth2 |
20001 | 卡号不存在或状态错误 | CARD_NUMBER_ERROR | 业务 | — | 2 | /cardBind/addCardBind |
20002 | 卡激活码错误 | CARD_ACTIVECODE_ERROR | 业务 | — | 0 | — |
20003 | 上传人脸错误 | VERIFY_FACE_ERROR | 业务 | — | 3 | /card/addCardBind |
20004 | 该卡号已经绑定 | CARD_ISBIND_ERROR | 业务 | — | 2 | /cardBind/addCardBind |
20005 | 平台不在白名单或接口签名错误 | OPENAPI_SIGN_ERROR | 业务 | — | 0 | — |
20006 | 旅游卡使用规则未设置 | CARD_MODEL_RULE_ERROR | 业务 | — | 2 | /card/updateCardActived |
20007 | 旅游卡超过最多绑定数量 | CARD_MODEL_RULE_BIND_ERROR | 业务 | — | 3 | /cardBind/addCardBind |
20008 | 旅游卡资源已禁用 | CARD_RESOURCE_RULE_STATUS_ERROR | 业务 | — | 5 | /cardAppointment/addCardAppointment |
20009 | 旅游卡资源无需预约 | CARD_RESOURCE_RULE_NO_APPOINTMENT | 业务 | — | 5 | /cardAppointment/addCardAppointment |
20010 | 该权益次数已用完，不可再预约哦！ | CARD_RESOURCE_RULE_COUNT_ERROR | 业务 | — | 6 | /cardAppointment/addCardAppointment |
20010 | 该旅游卡本月在本景区无可用次数 | CARD_RESOURCE_RULE_MONTH_COUNT_ERROR | 业务 | — | 6 | /cardAppointment/addCardAppointment |
20010 | 该旅游卡当天已经进行了核销，无需重复核销 | CARD_RESOURCE_RULE_DAY_COUNT_ERROR | 业务 | — | 9 | /cardAppointment/addCardAppointment |
20011 | 旅游卡已无分配资源 | CARD_ASSIGNMENT_ERROR | 业务 | — | 9 | /card/addCardOrder |
20012 | 预约库存不足 | CARD_APPOINTMENT_STOCK_ERROR | 业务 | — | 5 | /cardAppointment/addCardAppointment |
20013 | 预约场次库存不足 | CARD_APPOINTMENT_TIME_STOCK_ERROR | 业务 | — | 5 | /cardAppointment/addCardAppointment |
20021 | 订单不存在 | ORDER_NOTEXIST_ERROR | 业务 | — | 1 | /afterSales/refund |
20022 | 支付状态错误 | ORDER_PAYSTATUS_ERROR | 业务 | — | 1 | /afterSales/refund |
20023 | 订单状态错误 | ORDER_ORDERSTATUS_ERROR | 业务 | — | 1 | /afterSales/refund |
200024 | 旅游卡超过身份证最多绑定数量 | CARD_MODEL_RULE_BIND_ID_ERROR | 业务 | — | 2 | /cardBind/addCardBind |
200030 | 无权查看该统计数据 | HOME_STATS_FORBIDDEN | 业务 | — | 0 | — |
3. 还没覆盖的部分
管理后台另有一套
system_error_code 表（页面 src/views/system/errorCode），
用于运行时自定义提示语，与源码常量不保证一致。需要 DBA 导出该表并入 data/ 才能完全对齐。