第一步：留住最小证据
记录发生时间、目标服务与路径、HTTP 状态、请求 ID 和脱敏错误信息。不记录 Authorization 头或含个人信息的提示词。区分 HTTP 错误与应用自身 JSON 错误；代理返回的页面也可能是错误响应。不要只凭一张“网络错误”截图判断服务质量。
401：先检查身份
401 表示请求缺少有效认证凭据。确认 Key 属于当前目标平台、没有多余空格且认证头格式符合文档；再检查是否失效。不要为解决 401 无限重试或把 Key 发给陌生客服。若怀疑泄露，先撤销旧 Key，再替换服务端配置，清理日志中的副本。
429：降低压力再重试
429 表示请求过多。查看响应是否提供 Retry-After 以及服务商的额度说明，区分速率限制与额度不足。给重试设最大次数与总时限，用指数退避加随机抖动，避免多个任务同时冲击服务。流式请求已输出部分内容时，不能简单把重新生成的内容追加在旧输出之后。
502：检查上游与网关
502 表示网关收到无效的上游响应。保留请求 ID，检查供应商状态公告与本地代理配置。可以对可安全重放的请求进行有限重试，但不要在未确认时重复执行有副作用的工具动作。连续失败时暂停自动重试，向用户显示可恢复错误，必要时按预先批准的数据策略回退。
来源与适用边界
2026-10-21 阅读下列官方资料。操作步骤为本站编辑归纳，代码与数字为本地合成示例；未调用付费模型，不是服务商实测报告，也不构成接口或性能承诺。