Error401403429Debug
AI API 错误处理完全指南：401、403、429、500 详解与解决
在使用 AI API 时会遇到各种错误代码。本文详解每种错误的成因、排查步骤和预防方案，让你少走弯路。
401 Unauthorized
原因：API Key 不存在、已删除、已过期，或者请求头格式错误（应为 Bearer {key}）。
- 检查 API Key 是否正确粘贴
- 确认密钥未在控制台被删除
- 确认请求头是 'Authorization: Bearer xxx' 格式
403 Forbidden
原因：余额不足、套餐过期、账户被冻结，或者尝试访问未开通的模型。
429 Rate Limit
原因：触发了速率限制，通常是并发请求过多或短时间内调用次数超限。
- 添加带退避的重试逻辑（指数退避）
- 降低并发数
- 考虑升级套餐增加速率限制
500 Internal Server Error
原因：上游模型服务临时异常，通常不是你的代码问题。
- 等待 5-10 秒后重试
- 检查 ChinaWHAPI 状态页面
- 如果持续 500，联系技术支持
400 Bad Request
原因：请求体格式错误，通常是 JSON 格式不正确、model 名称不存在或缺少必要字段。
最佳实践
建议所有生产环境代码都实现：重试机制（带退避）、超时控制（建议 60-120 秒）、降级策略（主力模型不可用时切备选）和监控告警。