直接结论
5xx 表示服务端在处理请求时出现错误或不可用状态;短暂、受控重试可以合理,但不应无限重试。
症状和适用平台
- 500
- 502
- 503
- 529
判断边界:以下步骤用于缩小问题范围。它们不改变平台政策、账号资格、地区支持、付费状态或服务端事件。
原因分类
01服务端事件
先从可确认的产品/服务状态开始。
02上游依赖
通过单变量对照判断,不凭一次结果下结论。
03请求峰值
通过单变量对照判断,不凭一次结果下结论。
04偶发传输问题
通过单变量对照判断,不凭一次结果下结论。
逐步排查
- 01读取官方文档和状态页
先保留出现时间、产品与平台,不记录敏感材料。
- 02按退避策略重试少量次数
完成后观察结果,再决定是否进入下一步。
- 03保留脱敏时间线
完成后观察结果,再决定是否进入下一步。
- 04避免扩大并发
完成后观察结果,再决定是否进入下一步。
成功验证
恢复后最小请求成功,或官方状态解释事件
风险和限制
网络调整只能影响本地连接条件,不能保证账号永不受限,也不能绕过验证、地区、付费、滥用限制或其他安全控制。出现明确账号/政策/资格提示时,请转向官方支持。
官方来源
- OpenAI Developers|Error codes ↗API 401, 403, 429 and 5xx meanings;核对 2026年8月12日
- Anthropic Claude Platform Docs|Errors ↗Anthropic API error responses;核对 2026年8月12日
- Google AI for Developers|Troubleshooting guide ↗Gemini API errors, quotas and troubleshooting;核对 2026年8月12日
相关问题
常见问题
这一定是网络问题吗?
不一定。账号、浏览器、产品限制和服务端事件都可能产生相似症状。请按本文的对照顺序缩小范围。
我需要提供账号或完整日志吗?
不需要。使用时间、产品、平台、状态码和经过本地脱敏的错误摘要即可开始排查。