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 响应头,用于告诉客户端应采用什么认证方式。

例如:

text
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer
Content-Type: application/json

{"message":"authentication required"}

客户端看到 401 后,合理动作通常是重新登录、刷新访问令牌,或者重新提交有效认证信息。

403 表示身份明确,但权限不够

403 Forbidden 表示服务端已经理解请求,也已经知道调用者是谁,但当前身份没有权限完成这次操作。

例如普通用户已经成功登录,但尝试访问管理员接口:

text
GET /admin/users
Authorization: Bearer <TOKEN>

如果 <TOKEN> 合法,并且服务端确认该用户不是管理员,那么返回 403 比 401 更准确。

预期结果:

text
HTTP/1.1 403 Forbidden
Content-Type: application/json

{"message":"permission denied"}

这里重新登录并不能解决问题,因为身份本身没有失效。真正的问题是这个身份缺少所需角色、权限或资源访问范围。

用一组请求看清差异

假设 /profile 只要求登录,而 /admin/users 还要求管理员角色。下面示例中的 <PORT> 和 <TOKEN> 需要替换成实际值。

bash
curl -i "http://localhost:<PORT>/profile"

curl -i "http://localhost:<PORT>/admin/users"   -H "Authorization: Bearer <TOKEN>"

预期结果:

text
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 怎么配合

三者可以形成一个很实用的判断顺序:

  1. 身份是否有效? 无效或缺失,返回 401。
  2. 身份有效后,是否有权限访问? 没有权限,返回 403。
  3. 是否需要隐藏资源存在性? 如果安全策略要求避免资源枚举,可以考虑返回 404。

例如文件系统、订单详情、组织成员等接口,如果返回 403 会暴露资源 ID 的有效性,就可能选择 404 来减少信息泄露。

实际项目怎么选

可以把判断压缩成两句话:

  • 没有有效身份:返回 401。
  • 身份有效但权限不足:返回 403。

登录缺失、Token 过期、签名无效、Session 失效,用 401;角色不足、没有资源权限、缺少操作权限,用 403。如果还涉及隐藏资源存在性,再单独评估是否使用 404。

只要把“认证 Authentication”和“授权 Authorization”分开,401 与 403 的选择就不会再混乱。

目录与阅读设置

记录一个想法

HTTP 401 和 403 到底有什么区别

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通