错误码与排错

错误码的价值在于把“失败”转成可执行的诊断线索。遇到接口异常时，建议先记录 HTTP 状态码、业务错误码和请求上下文。

常见问题类别

• 鉴权失败：通常表现为 401 / 403
• 参数错误：通常表现为 400
• 余额或积分不足：如 INSUFFICIENT_CREDITS
• AI Provider 全部失败：如网关统一抛出的失败异常

排查顺序

1. 看 HTTP 状态码和业务码
2. 确认请求参数和资源 ID 是否正确
3. 确认调用者权限、版本能力和余额状态
4. 如涉及 AI，继续检查网关配置和 Provider 健康状态

记录建议

在排查复杂问题时，建议同时记录请求时间、调用链、用户或 Token 身份和受影响资源，便于与审计日志交叉验证。