502 Upstream Access Forbidden

这是最严重的错误等级

封禁级别，需要管理员介入。不是临时问题，重试无效。

错误样例

status_code=502, Upstream access forbidden, please contact administrator

含义

Shuro 网关成功到达了真上游（Anthropic 或更上层中转），但对方拒绝服务。让你联系管理员。

跟 503 的区别：

	503	502
触发	临时无可用账号	上游明确禁访
持续	几分钟自动恢复	不会自动恢复
处理	等 / 切模型	向平台反馈

5 种根因

#	根因	处理
1	网关 IP 被 Anthropic 封禁	平台换服务器
2	上游 key 被撤销/封号	平台换号
3	网关上游账号余额耗尽	平台充值
4	触发 Anthropic 滥用检测（高频同 prompt 等）	等 1-24h
5	你账号被风控	平台核查

处理步骤

1. 立即切到备用 Provider

如果你装了 CC Switch，**一键切到「Claude Official」**或其他中转商。

2. 截图 + 向平台反馈

错误时间: 2026-05-09 18:30
错误信息: status_code=502, Upstream access forbidden
我的 API Key 前 6 位: sk-XxXx (不要发完整 key)
我的 IP / 地理位置: 北京
最近一次成功使用时间: 30 分钟前

把上面信息通过平台反馈渠道提交，等回复。（TODO/VERIFY：Shuro 反馈渠道待确认）

3. 问对方关键问题

1. 是号池问题还是我账号问题？
2. 预计恢复时间？
3. 需要我换 key / 换套餐吗？

临时降级方案

在等待平台恢复期间：

bash

# 切到官方账号（如有 Max 订阅）
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
# 然后用官方 OAuth 登录
claude /login

# 或切其他中转商
export ANTHROPIC_BASE_URL="https://other-relay.example.com"
export ANTHROPIC_AUTH_TOKEN="<其他中转的 key>"
claude

跟其他错误的区分

看到的错误	严重度	跳转
`Auth rejected (401)`	🟢	→ 401
`No available accounts (503)`	🟡	→ 503
`Service unavailable (503)`	🟡	→ 503
`Upstream access forbidden (502)`	🔴 本页	—
`App unavailable in region`	🟡	→ 区域屏蔽

预防

虽然 502 不可完全避免，但可以降低概率：

不要短时间内大量发送相同 prompt（可能触发 Anthropic 滥用检测）
不要用一把 key 在多台机器同时跑高强度 agent（IP 异常分布）
不要用脚本扫描可用模型（看起来像爬虫）
正常人类速度使用

502 Upstream Access Forbidden ​

错误样例 ​

含义 ​

5 种根因 ​

处理步骤 ​

1. 立即切到备用 Provider ​

2. 截图 + 向平台反馈 ​

3. 问对方关键问题 ​

临时降级方案 ​

跟其他错误的区分 ​

预防 ​