HTTP 与 Web 标准 / 技术文章
HTTP 401 和 403 到底有什么区别
这篇文章解决一个最常见的鉴权状态码误用:请求被拒绝时,到底该返回 401 Unauthorized 还是 403 Forbidden。面向后端开发者、API 设计者和联调人员,读完后你可以根据“身份是否已确认、权限是否足够”快速做出正确选择。
先看结论
401 和 403 都表示客户端不能正常访问资源,但它们解决的不是同一个问题。
| 状态码 | 核心语义 | 客户端当前状态 | 下一步通常是什么 |
|---|---|---|---|
401 Unauthorized |
身份认证失败或缺失 | 还没有有效身份 | 登录、刷新 Token、重新认证 |
403 Forbidden |
身份已确认,但权限不足 | 已经知道是谁 | 申请权限、切换账号、停止访问 |
最实用的判断方式是:先问服务端是否已经确认调用者身份。没有确认,用 401;已经确认但没有权限,用 403。
401 表示身份认证没有通过
401 Unauthorized 应用于客户端没有提供认证凭据,或者提供的凭据无效、过期、无法被服务端接受的场景。
常见情况包括:
- 请求没有携带 Token。
- Token 已过期。
- Token 签名校验失败。
- Session 已失效。
- Basic Auth 用户名或密码错误。
此时服务端还不能可靠地确认“你是谁”,因此问题发生在认证 Authentication 阶段,而不是权限判断阶段。
对于使用 HTTP Authentication Scheme 的接口,401 响应通常还应该包含 WWW-Authenticate 响应头,用于告诉客户端应采用什么认证方式。
例如:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer
Content-Type: application/json
{"message":"authentication required"}客户端看到 401 后,合理动作通常是重新登录、刷新访问令牌,或者重新提交有效认证信息。
403 表示身份明确,但权限不够
403 Forbidden 表示服务端已经理解请求,也已经知道调用者是谁,但当前身份没有权限完成这次操作。
例如普通用户已经成功登录,但尝试访问管理员接口:
GET /admin/users
Authorization: Bearer <TOKEN>如果 <TOKEN> 合法,并且服务端确认该用户不是管理员,那么返回 403 比 401 更准确。
预期结果:
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"message":"permission denied"}这里重新登录并不能解决问题,因为身份本身没有失效。真正的问题是这个身份缺少所需角色、权限或资源访问范围。
用一组请求看清差异
假设 /profile 只要求登录,而 /admin/users 还要求管理员角色。下面示例中的 <PORT> 和 <TOKEN> 需要替换成实际值。
curl -i "http://localhost:<PORT>/profile"
curl -i "http://localhost:<PORT>/admin/users" -H "Authorization: Bearer <TOKEN>"预期结果:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"message":"permission denied"}第一条请求没有认证信息,因此服务端无法确认调用者身份,返回 401。第二条请求携带了有效 Token,但该身份没有管理员权限,因此返回 403。
这两个状态码对应的是两个不同层次的问题:401 是“你是谁还没确认”,403 是“知道你是谁,但你不能做这件事”。
最容易写错的几个场景
最常见的误用是所有鉴权失败都返回 401。这样虽然客户端仍然知道“请求失败了”,但会丢失认证和授权之间的语义差异。
另一个常见问题是 Token 过期时返回 403。Token 过期意味着当前认证凭据已经不能继续证明身份,本质仍然是认证失败,因此应该优先返回 401。
还有一种情况是用户已经登录,但访问了不属于自己的资源。例如用户 A 请求用户 B 的私有订单。此时服务端通常已经确认 A 的身份,问题在于资源权限,因此从协议语义上看更接近 403。
但在某些安全敏感接口中,服务端会故意返回 404 Not Found,避免泄露“这个资源确实存在”。这是安全策略上的取舍,不代表 403 的语义发生了变化。
401、403 和 404 怎么配合
三者可以形成一个很实用的判断顺序:
- 身份是否有效? 无效或缺失,返回
401。 - 身份有效后,是否有权限访问? 没有权限,返回
403。 - 是否需要隐藏资源存在性? 如果安全策略要求避免资源枚举,可以考虑返回
404。
例如文件系统、订单详情、组织成员等接口,如果返回 403 会暴露资源 ID 的有效性,就可能选择 404 来减少信息泄露。
实际项目怎么选
可以把判断压缩成两句话:
- 没有有效身份:返回
401。 - 身份有效但权限不足:返回
403。
登录缺失、Token 过期、签名无效、Session 失效,用 401;角色不足、没有资源权限、缺少操作权限,用 403。如果还涉及隐藏资源存在性,再单独评估是否使用 404。
只要把“认证 Authentication”和“授权 Authorization”分开,401 与 403 的选择就不会再混乱。