请求排查
Claude API 错误 529:过载、证据与重试
Claude 文档将 529 overloaded_error 定义为暂时的 API 过载。它与 429 请求或支出限制不同,单个响应不能确认事件影响范围。
简要回答
Claude 文档将 529 overloaded_error 定义为暂时的 API 过载。它与 429 请求或支出限制不同,单个响应不能确认事件影响范围。
读取响应和流
Claude 区分 529 过载与 429 请求限速。文档还说明流式错误可能在 HTTP 200 后到达;应检查流中的错误和完成情况,不能仅依赖响应头。
建议的应用处理方式
对于暂时过载响应,应设置有界延迟和重试预算,并考虑 SDK 已执行的重试。保留请求 ID 和时间用于排查。不能仅因模型请求失败就重复执行 Agent 后续动作。
将官方报告中的 Claude API 组件与失败时间对照。已保存的 Claude 报告包含多个产品,不验证每个模型、账户或地区。如果通过路由服务调用 Claude,也应检查该路由服务的错误与范围。
相关服务页面
每个条目显示自己的采集覆盖。链接到服务不一定表示自动采集。
编辑审核日期适用于本指南。实时报告采集时间显示在服务页面。