先定位故障，
再采取动作。
输入状态码、SDK 异常或错误字符串，快速找到原因、检查顺序和修复后的验证方法。
ENTRIES .... 40CATEGORIES . 9HTTP ....... 400 / 401 / 403 / 429 / 5XXRESPONSES ... STATUS / TOOL / OUTPUTMODE ....... EVIDENCE FIRST按故障层快速进入
高意图错误诊断
AI API 返回 401 Unauthorized 怎么办
请求未通过身份验证
查看诊断 →[HTTP 403]AI API 返回 403 Forbidden 怎么办
身份可能已识别，但操作被拒绝
查看诊断 →[HTTP 429]AI API 返回 429：速率限制与配额排查
请求过多或配额不足
查看诊断 →[TIMEOUT]AI 模型请求超时：从客户端到上游逐层排查
连接、首字节或完整响应超过时限
查看诊断 →[HTTP 500]AI API 返回 500：服务端错误如何安全排查
服务端处理请求时发生未预期错误
查看诊断 →[HTTP 502]AI API 返回 502 Bad Gateway 怎么排查
网关或反向代理未能从上游模型服务获得有效响应
查看诊断 →[HTTP 503]AI API 返回 503 Service Unavailable 怎么处理
服务暂时无法处理请求，可能处于过载、维护或依赖故障状态
查看诊断 →[GUIDE]OpenAI Responses API返回incomplete、空output_text或截断：排查指南
先记录 HTTP 状态、响应 ID、model、status、incompletedetails、usage、output 中每个 item 的 type/status，以及 message content 的具体类型。若 status=i
查看诊断 →最近更新
Claude API 返回 529 Overloaded Error 怎么解决
Anthropic API 暂时过载，返回 overloaded_error
查看诊断 →[TIMEOUT]DeepSeek API 请求超时：连接、读取与流式中断排查
请求在连接、等待首字节、读取响应或流式传输过程中超过客户端期限或中断
查看诊断 →[HTTP 400]Gemini API 返回 400 INVALID_ARGUMENT 怎么排查
Gemini API 指出请求正文格式不正确、字段缺失或参数与端点不匹配
查看诊断 →[MIGRATION]OpenAI-compatible API 迁移失败：base_url、/v1、Chat Completions 与 Responses 路径排查
更换兼容服务、SDK 或 API 形态后出现 404、401、400、响应字段不匹配或流式解析错误
查看诊断 →[GUIDE]AI API SSE流式输出卡住、截断或重复：代理缓冲排查指南
先绕过代理直连上游，记录首字节时间、每个数据块的到达时间和字节数，再逐层加回 Nginx/CDN/网关。确保成功响应使用与 SSE 一致的 text/event-stream，代理不对该路由做响应缓冲，读取超时大于允许的无数据间隔，且客户端
查看诊断 →[GUIDE]AI API流式响应中的delta、done、stop_reason和连接关闭有什么区别？
delta是尚在生成过程中的增量片段；内容级 done表示某个文本或内容块已定稿；响应级 completed或最终结束事件表示整个模型响应成功完成；finishreason或 stopreason说明模型为何停止生成；连接关闭只说明传输通道
查看诊断 →[GUIDE]API返回200却JSON解析失败：HTML错误页、空响应与Content-Type排查
先不要直接解析JSON。检查最终响应URL和重定向历史，再读取 Content-Type、Content-Encoding 与正文长度；把正文作为文本保存前几百个字符并脱敏。如果Content-Type不是JSON、正文以HTML标签开头或
查看诊断 →[GUIDE]OpenAI API返回429怎么排查：RPM、TPM、项目限额与指数退避检查清单
先记录 HTTP 429、响应中的错误类型与错误码、x-request-id，以及 x-ratelimit-limit-、x-ratelimit-remaining-、x-ratelimit-reset- 响应头。确认请求实际使用的组织、项
查看诊断 →