错误排查

更新于 2026-09-20 · 页面与服务规则以当前控制台为准

30 秒自查

先记录 完整错误、请求域名、分组、模型与时间 ，再对照下表。相同状态码可能有不同原因，优先看错误正文。

现象	先做什么
401，地址是 api.openai.com	检查当前供应商，确认请求没有继续走官方入口
401，地址是本站	核对 Key、有效期、启用状态和鉴权方式
403，This token has no access to model	核对密钥分组与模型权限
402／余额不足	同时查密钥限额、钱包余额、套餐适用范围
404 Not Found	检查基础地址、协议和 /v1 是否重复或缺失
400 Header Or Cookie Too Large	检查浏览器 Cookie 或客户端请求头，按下面步骤处理
413 Payload Too Large	减少附件与上下文，缩小请求后重试
429	降低请求频率与并发，等待后有限重试
502／stream disconnected	对比线路、代理、请求日志与上游状态
503 No available channel	当前分组／模型无可用渠道，查状态后等恢复或换可用分组
所有供应商已熔断	查看本地代理或客户端具体失败原因，不要无限重试

401：认证失败

请求去了 api.openai.com： 确认在 CC Switch 启用了 DragonAPI、应用使用了正确配置目录，并彻底退出再打开。检查用户配置、环境变量、当前供应商与登录方式；不要先卸载全部软件。

请求去了本站： 重新复制完整 Key，去掉空格；检查禁用、过期、Key 是否更新。仅修改原 Key 的分组通常不要求重建 Key，先核对模型权限。

更新软件后出现： 备份配置，再核对版本的自定义 Provider 鉴权。requires_openai_auth = true 与 env_key 不是可随意叠加的修复开关；见 Codex CLI。

不要直接删整个 .codex 目录。必要时只在备份后修正具体配置，并保留会话、项目和其他设置。

403：权限或策略拒绝

正文包含 This token has no access to model 时，先选该分组有权限的模型。其他 403 可能涉及访问策略、风控、账户状态或上游限制，不能一律认定为敏感词。

正常使用被误拦，私发管理员用户名、时间、模型和请求 ID。不要公开完整密钥，也不要反复尝试绕过限制。

402 或账户有余额却不能用

检查密钥自己的额度和状态、钱包余额、套餐当期额度、套餐支持分组与扣费偏好。都正常时请管理员核查上游额度或渠道，不要重复充值来试错。

404 与缺少模型

Codex／OpenAI 兼容客户端通常填 https://newapi.dragon3api.com/v1；Claude Code 的 Anthropic 兼容地址填 https://newapi.dragon3api.com。

model 不能为空；使用完整模型 ID。不要把 /v1 写两次，也不要在只接收基础地址的字段中填整个 /chat/completions 路径。

400：请求头、Cookie 或参数异常

看到 nginx 的 Request Header Or Cookie Too Large，含义是请求头或 Cookie 太大， 不等于会话必然损坏 。

• 浏览器出现：先用无痕窗口验证；若只有旧窗口失败，清理该站点的 Cookie 后重新登录，会退出当前会话。
• 客户端出现：检查代理是否重复附加请求头、是否有异常自定义 Header；保留配置备份后修正。
• 只有某个对话失败：可新建短对话比较，保留旧对话记录。
• 正文说“缺少模型”或“没有可用对话模型”：检查模型字段和分组权限。

413：请求体过大

减少一次性上传的图片、PDF 与长文本；把材料拆分为较小的必要部分。可以让旧会话先生成交接摘要，再开启新会话并提供摘要和相关文件。

新会话不一定能读取旧会话链接。 不要仅丢一个链接就假定上下文已迁移。具体长度限制取决于模型、接口与网关，不能用统一的 token 数字保证通过。

429：请求过于频繁

降低并发，暂停批量任务，遵循响应中的 Retry-After（若有）。设置有上限的退避重试，避免立即循环请求。长期限流时查看分组状态并联系支持。

502 或流式中断

可能发生在客户端代理、CDN、网关或上游。按 线路排查逐项比较：请求有无进入本站日志、短请求是否正常、当前线路是否适合长任务、代理是否稳定。

不要把“换 Pro 仍失败”作为唯一证据认定网络问题；也不要把所有 502 归因于 CC Switch。

503：无可用渠道或熔断

No available channel for model … under group … 表示该组合当前没有可用渠道，可能是临时供给、健康状态或模型配置问题。确认模型确实属于当前分组，再查群内状态；必要时换一个确实包含该模型的可用分组。

“所有供应商已熔断”也可能是客户端／本地代理对连续失败的保护。先读它记录的原始错误，排除网络与认证问题后再重试。

测试成功但实际使用失败

对比测试和对话所用的模型、地址、协议、思考强度、附件和上下文长度。完全退出客户端再新建短对话，并以控制台日志中的实际请求为准。

思考强度与预期不一致时，核对 CC Switch 和实际生效配置；也可能是客户端能力、模型支持范围或上游处理不同，带请求 ID 核查，不能只凭显示认定本站改参。

缓存、自动审核与 image-studio 密钥

缓存变化： 受模型、前缀、会话、路由及过期时间影响，不能承诺稳定命中。先以相近请求比较日志中的输入、缓存和输出用量。

自动审核模型不可用： 如果报错明确指向未开放的模型，按当前客户端设置选择可用模型或调整该功能。旧资料提到 Luna 是当时的限制，不代表所有版本都应关闭自动审核。

自动出现 image-studio 密钥： 打开本站生图工作台时，系统可能为该功能创建专用密钥，属于功能配套。密钥异常或生图失败时请联系管理员核查。

还是解决不了

按 求助模板提供账号、时间、分组、模型、域名和请求 ID。付款截图、个人信息与密钥应遮挡，向管理员私发必要材料。