Claude API 返回 529 Overloaded Error 怎么解决

先确认错误层与证据

记录 UTC 时间、HTTP 状态、error.type、message、模型、端点、SDK 版本、request_id 和 Retry-After。Anthropic 的错误响应包含 request_id，响应头也带 request-id；它是联系支持时的关键关联字段。所有日志都必须删除 API key、Authorization 头和用户敏感内容。

529 与 429、503 的区别

529 overloaded_error 表示 Anthropic API 暂时过载，文档说明它可能发生在全体用户流量高时。429 则需要继续判断速率限制、消费上限或组织层限制；503 是 HTTP 的临时不可用语义。不能凭“busy”字样把三者混为一种策略。

安全的有限重试

先尊重 Retry-After；未提供时，使用含随机抖动的指数退避，并规定最大尝试次数、总截止时间和调用链唯一的重试预算。官方 SDK 对连接错误、限流和 5xx 等短暂失败默认可重试，但业务层仍要避免与 SDK 叠加成倍重试。仅对读取或已由幂等键保护的操作重放。

attempt=1 wait=random(1s,2s)
attempt=2 wait=random(2s,4s)
# 超过业务总截止时间立即停止，而不是无限循环

流式响应的特殊情况

SSE 流可能先返回 HTTP 200，再在中途出现错误事件。此时不能把初始 200 当成完整成功，也不能把已收到的片段直接入库为完整结果。按事件协议保存完成、失败或中断状态；若业务具有副作用，先用业务 ID 或状态查询确认是否已执行。

恢复与升级条件

临时可降低并发、暂停非关键批处理并让可恢复任务延迟重排。只有完成模型兼容性、数据权限、成本和输出质量验证，才考虑多模型恢复路径。遵循退避后仍持续失败、不同最小请求均可复现时，提交时间范围、模型、SDK 版本、脱敏请求与 request ID 给官方支持。

529 和 Claude 的 429 是同一件事吗？

不是。529 是官方定义的暂时过载；429 还可能与速率限制或额度相关，应按响应类型和官方说明分别处理。

收到 529 后能立即切换模型吗？

只有完成兼容性、权限、成本和输出质量验证后才可切换。切换不是对幂等性、退避和错误记录的替代。