首页/网络/协议速查/401 Unauthorized 未认证
本包目录(405 条)
HTTP 方法与状态码91 条
HTTP 头与缓存70 条DNS 与域名解析60 条TCP 与 UDP54 条TLS 与加密50 条IP 与 ICMP37 条邮件与文件传输43 条

401 Unauthorized 未认证

请求缺少有效凭证:认证未通过(名字叫 Unauthorized,实际含义是 Unauthenticated),响应必须带 WWW-Authenticate 挑战。

协议速查网络更新于 2026-10-12
名称401 Unauthorized
作用要求认证 / 认证失败
规范RFC 9110 §15.5.2;RFC 7617 Basic;RFC 6750 Bearer
关键头部WWW-Authenticate

Basic 认证交互

Basic 认证交互
curl -si https://api.example.com/private
# HTTP/1.1 401 Unauthorized
# WWW-Authenticate: Basic realm="api", charset="UTF-8"

curl -si -u user:pass https://api.example.com/private
Bearer Token 过期导致的 401,应同时用响应体给出机器可读错误码(如 token_expired),方便客户端做刷新令牌流程。

易错点

  • 401 不带 WWW-Authenticate 头违反规范,部分客户端(浏览器弹窗、SDK)无法正确处理
  • 把权限不足错发成 401,会让客户端误以为重登就能解决(实际是 403)

数据来源与参考

  • RFC 9110 §15.5.2 401
  • RFC 7617 Basic 认证
  • RFC 6750 Bearer Token

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌