401Unauthorized未认证

401 Unauthorized 表示请求缺少有效的身份凭据。它的名字容易误导:这是“未认证”,不是“没权限”。服务器必须用 WWW-Authenticate 头说明认证方式。

DeepSeek 娘在安检闸机前抬手拒绝一位西装男递来的证件。
图版 02401 Unauthorized客户端错误

是什么意思?

服务器可以接受凭据,但请求没带,或者带的凭据被拒绝了。客户端可以换一个 Authorization 头重试。

如果客户端已经试过,服务器仍返回同样的挑战,用户代理应该把响应内容展示给用户,里面通常会解释原因。

什么时候会出现?

  • 访问令牌缺失、过期或格式错误。
  • 登录表单提交了错误的密码。
  • API key 没带,或者放错了请求头。

怎么处理?

如果你是开发者

  • 返回 WWW-Authenticate,至少给出一种认证挑战。没有这个头的 401 是不完整的。
  • 错误内容要短且有用;不要泄露某个用户名是否存在。
  • 用户已经通过认证但没有权限时,用 403,不要用 401。

如果你只是访客

  • 重新登录,或者确认自己用的是正确的账号。
  • 如果已经登录,清掉这个站的会话再试。

技术信息

状态类
客户端错误
默认是否可缓存
否
常见响应头
WWW-Authenticate

相关状态

出处