DeepSeek API 401 未授权排查指南
401 是大模型接入阶段最常见的错误之一。它通常不复杂，但如果排查顺序不对，很容易在环境变量、代理层和 SDK 配置里来回兜圈。
从 Key、环境变量、请求头到账号状态，快速定位 401 的常见根因。
适合谁看
适合正在接第三方模型 API、做兼容层、排线上报错的开发者和团队。
这篇会回答
• 先确认最容易出错的四个地方
• 区分代码问题和环境问题
• 线上环境最容易忽略的坑
这篇在专题里的位置
围绕 401、402、429、503、504、流式输出、兼容接口、Key 管理和网关接入，先解决“能不能稳定跑起来”。
Claude API 接入清单
从模型选择、请求结构到限流与日志，梳理一份更稳的接入流程。
Claude acceleration limits 是什么，为什么刚放量就 429
根据 Anthropic 官方文档，拆开讲 acceleration limits、短时间突发流量和 rate limit 的区别，方便你判断为什么总量没超、请求还是被卡。
Claude API 401 authentication_error 怎么排查
根据 Anthropic 官方错误文档和 API 接入说明，拆开讲 Console Key、请求头、版本头和代理转发问题，方便你快速定位 Claude API 的 401 authentication_error。
先确认最容易出错的四个地方
先看 API Key 是否真的来自当前服务商控制台，而不是旧项目、旧环境或测试账号。
再检查请求头是否按官方要求传递，尤其是 Authorization 字段是否包含正确的 Bearer 前缀。
环境变量名是否写错
本地和线上是否使用了不同的配置文件
代理层是否剥掉了认证头
账号余额、权限或风控状态是否异常
区分代码问题和环境问题
最稳的方法是先用最小 curl 或 Postman 请求做一次直连。如果最小请求能通过，问题基本就在你的应用层封装里。
如果最小请求也失败，就先回到平台控制台检查 Key 状态和调用范围，不要一上来怀疑 SDK。
线上环境最容易忽略的坑
线上部署常见问题不是 Key 本身，而是注入方式。比如 PM2、Docker、面板环境变量和 .env 文件优先级不一致。
如果你做了多环境部署，建议把服务启动时实际读取到的配置来源写进日志，但不要直接打印明文 Key。
常见问题
401 和 403 的区别是什么？
401 更偏向认证失败，表示当前凭据无效或未被识别；403 更偏向凭据有效但没有访问该资源的权限。
更换新 Key 后还是 401 怎么办？
优先排查是否仍然在读取旧环境变量、旧容器缓存或旧进程配置，尤其是长驻服务没有重启的情况。
继续沿着这条主线看
这部分不再重新给你一堆大卡片，而是直接把下一步阅读顺序列出来，方便继续往下走。
Claude API 接入清单
从模型选择、请求结构到限流与日志，梳理一份更稳的接入流程。
Claude acceleration limits 是什么，为什么刚放量就 429
根据 Anthropic 官方文档，拆开讲 acceleration limits、短时间突发流量和 rate limit 的区别，方便你判断为什么总量没超、请求还是被卡。
Claude API 401 authentication_error 怎么排查
根据 Anthropic 官方错误文档和 API 接入说明，拆开讲 Console Key、请求头、版本头和代理转发问题，方便你快速定位 Claude API 的 401 authentication_error。
Claude API 529 overloaded 怎么处理
根据 Anthropic 官方错误文档、Rate Limits 和状态页，拆开讲 529 overloaded 与 429、401 的区别，以及线上更稳的重试、降级和观察路径。