dingdanquanliucheng/backend/app/core/error_codes.py

29 lines
1.1 KiB
Python
Raw Normal View History

"""统一业务错误码常量定义。
所有 API 返回的错误码在此集中管理避免魔法数字散落在各路由中
前端根据 code 字段判断请求是否成功0 = 成功
"""
2026-05-14 13:51:06 +08:00
class ErrorCode:
"""业务错误码HTTP 状态码与业务码分离。
错误码规则
- 0: 成功
- 4xxxx: 客户端错误参数认证权限业务规则等
- 5xxxx: 服务端错误
"""
SUCCESS = 0 # 请求成功
PARAM_ERROR = 40001 # 参数校验失败
UNAUTHORIZED = 40002 # 未登录或 token 无效
FORBIDDEN = 40003 # 无权限访问
NOT_FOUND = 40004 # 资源不存在
INVALID_STATUS = 40005 # 状态不允许当前操作
DUPLICATE = 40006 # 数据重复
BUSINESS_RULE_FAILED = 40007 # 业务规则校验失败
FILE_UPLOAD_FAILED = 40008 # 文件上传失败
THIRD_PARTY_FAILED = 40009 # 第三方服务调用失败
SYSTEM_ERROR = 50000 # 系统内部错误
2026-06-19 23:03:14 +08:00
INTERNAL_ERROR = 50000 # 内部错误(别名,兼容旧代码)