为什么请求返回 401 Unauthorized？

401 错误居高不下？分析最常见的 3 种原因并提供对应的快速修复方法。

收到 401 Unauthorized 意味着 Sub2API 网关未能识别你的身份。在排除网络问题后，绝大多数 401 都由下面三种原因导致。按照表格逐项排查，通常可以在几分钟内解决。

快速排查表

原因	常见表现	修复方法
Header 格式错误	拼错 Bearer 或遗漏空格	改为 Authorization: Bearer YOUR_API_KEY
API Key 已删除或失效	Key 曾在控制台中被手动删除	登录控制台重新创建 API Key
Key 内有多余空格	复制时前后带空格或换行	对 Key 做 trim 处理后再放入 Header

正确的 Header 示例

下面是一个格式完全正确的请求 Header：

Authorization: Bearer sk-sub2api-xxxxxxxxxxxx
Content-Type: application/json

请特别注意以下几点：

• Bearer 首字母大写，后面紧跟一个空格
• API Key 前后不要有空格、换行或引号
• Header 名称必须是 Authorization，不要写成 Auth、Api-Key 等其他形式

常见错误写法

缺少 Bearer

Authorization: sk-sub2api-xxxxxxxxxxxx

如果以上都确认无误仍然 401

1. 检查 API Key 是否仍在控制台中有效列表里（可能已被你或团队成员误删）
2. 确认发送请求的环境与创建 Key 时的账户一致
3. 检查是否有代理或中间件篡改了 Header

如需更完整的诊断流程和高级排查步骤，请参阅 401 完整排错指南。