报 503 overloaded_error「上游线路暂时不可用」怎么解决

同一个问题的其他写法

• Upstream overloaded after 3 attempt(s): Our servers are currently overloaded. Please try again later.
• API Error: Repeated 529 Overloaded errors
• {"type":"error","error":{"type":"api_error","message":"Upstream returned invalid response"}}

这个 503 是怎么产生的

CCSub 背后有多条上游线路。一个请求失败时，CCSub 不会马上把错误交给你，而是先自己处理：

• 上游返回 5xx、超时或者「过载」时，会把请求换到同型号的其他账号或线路上重试；
• 有些上游在过载时先返回 200、再在流里塞一条错误，CCSub 会识别出这种情况并同样换线重试；
• 连续失败的线路会被暂时标记，后续请求绕开它。

只有这些重试都用完、这一刻确实没有可用线路时，你才会看到 503。所以它代表的是「这一两分钟里这个型号的可用线路不够」，通常很快恢复。

几种文案分别对应什么

• 上游线路暂时不可用，请稍后重试（不是您账户余额的问题）：上游线路的账户出了问题（比如余额），CCSub 把原始错误改写成这句，与你的账户无关。
• Upstream overloaded after N attempt(s): ...：上游报过载，CCSub 已经换了 N 次账号仍然过载。
• API Error: Repeated 529 Overloaded errors：Claude Code 自己的提示，表示连续多次收到 529 过载并且重试已经用完。
• 502 Upstream returned invalid response、500 Internal proxy error：上游返回了无法解析的内容，或者处理过程中出了意外，处理方式和 503 相同，重试即可。

这些错误都不会扣费：只有成功返回结果的请求才会计费。

怎么处理最快

1. 等一两分钟再发一句「继续」。 Claude Code 官方文档也建议这样做：原来的消息还在会话里，不需要重新粘贴长提示词。
2. 换个型号。 用 /model 切换，或者在 Codex、Cursor 等工具里换一个 model 标识。不同型号的请求可能走不同的线路，一个型号没有可用线路时，换一个通常就能继续干活。
3. 长任务分段做。 很长的单轮任务一旦失败要整轮重来，拆成几步做，每一步失败的代价更小。
4. 自己写代码时做好退避重试。 遇到 502、503、529 时等几秒再重试，每次失败把间隔翻倍，3 到 5 次后放弃并提示用户。不要零间隔地循环重发，那样还会撞上 429 限流。

什么时候需要联系客服

如果同一个型号持续 10 分钟以上都是 503，或者换了型号仍然全部失败，发邮件到 support@ccsub.net，附上：

• 出错的时间，精确到分钟；
• 工具名称和版本（claude --version 或 codex --version）；
• 使用的 model 标识和完整报错文本；
• 你的注册邮箱（不要发 API Key）。

有了时间和型号，客服可以直接在请求日志里定位到具体是哪一次失败。

常见问题

相关报错

• API Error: 504 {"type":"error","error":{"type":"timeout_error","message":"Upstream timed out"}}等上游的时间超过上限了。自己调用时改成流式（stream: true），上下文太长就 /compact，长输出拆成几次；偶发一次直接重试即可，不计费。
• API Error: 402 {"type":"error","error":{"type":"insufficient_balance","message":"余额不足，请前往 https://www.ccsub.net/purchase 充值"}}账户可用余额不够，或月卡当天额度用完。看 message 是哪种：充值按量余额、等北京时间 0 点额度重置，或在余额本来够时等几分钟再试。
• API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"API Key request rate exceeded"}}每分钟请求数超了就在 Keys 页面调高这把 Key 的速率或分开用多把 Key；并发超了就减少同时跑的会话和子代理——并发按账号计算，多建 Key 没用。