BAD_REQUEST | 400 | General | 客户端请求语法错误，服务器无法理解。 | 1. 检查请求格式是否符合API文档要求。2. 验证JSON格式是否正确。 |
INVALID_PARAMETER | 400 | General | 请求参数无效或格式错误。 | 1. 检查参数名称和值是否符合要求。2. 参考API文档确认参数格式。 |
MISSING_REQUIRED_FIELD | 400 | General | 缺少必要的请求参数或字段。 | 1. 查看API文档确认必填字段。2. 在请求中包含所有必需字段。 |
VALIDATION_FAILED | 400 | General | 数据验证失败。 | 1. 检查输入数据是否符合业务规则。2. 验证数据格式和范围。 |
UNAUTHORIZED | 401 | Auth | 请求要求身份验证。 | 1. 检查是否提供了有效的认证令牌。2. 重新登录获取新的认证凭证。 |
INVALID_CREDENTIALS | 401 | Auth | 提供的身份验证凭据无效。 | 1. 检查用户名和密码是否正确。2. 重新获取有效的认证令牌。 |
TOKEN_EXPIRED | 401 | Auth | 认证令牌已过期。 | 1. 使用刷新令牌获取新的访问令牌。2. 重新进行身份验证。 |
TOKEN_INVALID | 401 | Auth | 认证令牌无效。 | 1. 检查令牌格式是否正确。2. 获取新的有效令牌。 |
FORBIDDEN | 403 | Auth | 服务器理解请求但拒绝执行。 | 1. 确认当前用户是否有执行此操作的权限。2. 联系管理员获取相应权限。 |
INSUFFICIENT_PERMISSIONS | 403 | Auth | 当前用户权限不足。 | 1. 联系管理员获取所需权限。2. 使用具有足够权限的账户操作。 |
ACCESS_DENIED | 403 | Auth | 访问被拒绝。 | 1. 确认是否有权访 问该资源。2. 联系资源所有者获取访问权限。 |
RESOURCE_ACCESS_DENIED | 403 | Auth | 无权访问该资源。 | 1. 确认资源是否存在且可访问。2. 联系资源所有者获取访问权限。 |
NOT_FOUND | 404 | General | 请求的资源不存在。 | 1. 检查请求的URL是否正确。2. 确认资源是否已被删除。 |
USER_NOT_FOUND | 404 | User | 指定的用户ID不存在。 | 1. 检查用户ID是否正确。2. 用户可能已被删除。 |
RESOURCE_NOT_FOUND | 404 | General | 请求的资源不存在。 | 1. 检查资源ID是否正确。2. 资源可能已被删除或移动。 |
ENDPOINT_NOT_FOUND | 404 | API | 请求的API端点不存在。 | 1. 检查URL路径是否正确。2. 参考API文档确认可用端点。 |
FILE_NOT_FOUND | 404 | Storage | 请求的文件不存在。 | 1. 检查文件路径是否正确。2. 文件可能已被删除或移动。 |
METHOD_NOT_ALLOWED | 405 | API | 请求方法不被允许。 | 1. 检查HTTP方法是否正确（GET/POST/PUT/DELETE等）。2. 参考API文档确认支持的请求方法。 |
REQUEST_TIMEOUT | 408 | Network | 请求超时。 | 1. 检查网络连接是否稳定。2. 稍后重试请求。 |
CONFLICT | 409 | General | 请求与当前资源状态冲突。 | 1. 检查资源当前状态。2. 解决冲突后重试请求。 |
RESOURCE_ALREADY_EXISTS | 409 | General | 资源已存在。 | 1. 检查是否尝试创建已存在的资源。2. 使用更新操作替代创建操作。 |
USER_ALREADY_EXISTS | 409 | User | 用户已存在。 | 1. 检查是否尝试注册已存在的用户名/邮箱。2. 使用登录功能或找回密码功能。 |
GONE | 410 | General | 请求的资源已被永久删除。 | 1. 此资源已无法恢复。2. 如有需要，创建新资源。 |
PAYLOAD_TOO_LARGE | 413 | Network | 请求体过大。 | 1. 减少请求体大小。2. 拆分请求为多个较小请求。 |
UNSUPPORTED_MEDIA_TYPE | 415 | API | 不支持的媒体类型。 | 1. 检查Content-Type头是否正确。2. 使用API支持的媒体类型（如application/json）。 |
UNPROCESSABLE_ENTITY | 422 | Business | 请求格式正确，但语义错误。 | 1. 检查业务逻辑约束。2. 确保请求符合所有业务规则。 |
VALIDATION_ERROR | 422 | Business | 数据验证错误。 | 1. 检查输入数据是否符合所有验证规则。2. 修正数据后重试。 |
RATE_LIMIT_EXCEEDED | 429 | System | 请求频率超过限制。 | 1. 降低请求频率。2. 等待限制重置后重试。 |
TOO_MANY_REQUESTS | 429 | System | 请求过多。 | 1. 减少请求数量。2. 实现适当的请求节流机制。 |
INTERNAL_SERVER_ERROR | 500 | System | 服务器内部错误。 | 1. 稍后重试请求。2. 联系系统管理员。 |
DATABASE_ERROR | 500 | Database | 数据库错误。 | 1. 稍后重试请求。2. 联系数据库管理员。 |
INTERNAL_ERROR | 500 | System | 内部错误。 | 1. 稍后重试请求。2. 联系系统管理员查看日志。 |
NOT_IMPLEMENTED | 501 | API | 服务器不支持请求的功能。 | 1. 检查API版本是否支持此功能。2. 联系API提供方确认功能可用性。 |
BAD_GATEWAY | 502 | Network | 网关或代理服务器从上游服务器收到无效响应。 | 1. 稍后重试请求。2. 联系系统管理员检查上游服务状态。 |
UPSTREAM_SERVICE_UNAVAILABLE | 502 | System | 上游服务不可用。 | 1. 稍后重试请求。2. 联系系统管理员检查上游服务状态。 |
SERVICE_UNAVAILABLE | 503 | System | 服务暂时不可用。 | 1. 稍后重试请求。2. 查看系统状态页面获取维护信息。 |
MAINTENANCE_MODE | 503 | System | 系统维护中。 | 1. 等待维护完成后重试。2. 查看公告获取维护时间表。 |
GATEWAY_TIMEOUT | 504 | Network | 网关或代理服务器等待上游服务器响应超时。 | 1. 稍后重试请求。2. 联系系统管理员检查上游服务性能。 |
INSUFFICIENT_STORAGE | 507 | Storage | 服务器存储空间不足。 | |