请求排查

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,也应检查该路由服务的错误与范围。

相关服务页面

每个条目显示自己的采集覆盖。链接到服务不一定表示自动采集。

编辑审核日期适用于本指南。实时报告采集时间显示在服务页面。