← 中文资源

简体中文版本

HTTP 401 Unauthorized 与 WWW-Authenticate

通过读取 WWW-Authenticate 头、检查令牌格式来诊断 HTTP 401,并区分令牌过期与凭据缺失。

阅读英文原文

症状

API 返回 401 Unauthorized,并带有 WWW-Authenticate: Bearer。它可能只在会话变旧后出现,或来自某个对请求头处理不同的客户端。

诊断

读取质询并解码令牌:

curl -i https://api.example.com/me
# WWW-Authenticate: Bearer realm="api", error="invalid_token"

# decode the payload (middle segment) to inspect claims
echo '<payload>' | base64 -d

对照校验方配置检查 exp、iss 与 aud。

修复

使用正确的认证方案并及时刷新:

curl -H 'Authorization: Bearer eyJ...' https://api.example.com/me

对齐签名密钥,并为时钟偏差留出小量容差。

验证

用新令牌重试;端点返回 200,响应头的 WWW-Authenticate 中不再带 error,确认凭据已有效。