什么是 JWT?结构、签名与安全使用

三个用点分隔的 base64url 片段——头部、载荷与签名。了解每一部分证明了什么、没证明什么,以及会把 JWT 变成安全漏洞的五个错误。

📂 开发者必备 ⏱ 约 11 分钟 📶 中级 🛠️ 搭配工具:JWT 解码器

你将学到什么

  • 读懂 JWT,说出它的三个部分
  • 解释签名能证明什么——以及不能证明什么
  • 正确使用标准声明(exp、iss、aud、sub)
  • 判断什么时候 JWT 胜过服务器端会话(以及什么时候不如)
  • 避开五种经典的 JWT 安全错误
本指南目录
  1. 什么是 JWT
  2. 结构解析:三个部分
  3. 签名与验证如何工作
  4. 标准声明
  5. 什么时候用 JWT——什么时候不用
  6. 常见错误
  7. 试一试:JWT 解码器
  8. 常见问题

什么是 JWT

A JSON Web Token(JWT) 是一种在两方之间传递已签名声明的紧凑、URL 安全的方式。它长这样:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IlZhbGV2IiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

三段内容,用点分隔: header.payload.signature。服务器在你登录后创建一个发给你,之后你每次请求都要把它带回去——通常放在 Authorization: Bearer <token> 请求头里。服务器验证签名后就信任里面的声明,无需查数据库。这种“无需查询”的特性正是 JWT 的全部意义——同时我们也会看到,它也是主要的弱点。

结构解析:三个部分

每个部分都是 经 Base64URL 编码的 JSON (Base64 的变体,其中 +// 被替换为 -/_ ,且去掉了填充,所以它能在 URL 中完好使用)。把上面的例子解码后,你会得到:

// Header — how the token is signed
{ "alg": "HS256", "typ": "JWT" }

// Payload — the claims (statements about the user)
{ "sub": "1234567890", "name": "Valev", "admin": true, "iat": 1516239022 }

// Signature — HMAC-SHA256 over header.payload, with a secret key
部分内容保密吗?
头部签名算法(alg)和类型(typ)不是——任何人都能读
负载声明:你是谁、你能做什么、何时过期不是——任何人都能读
签名头部 + 负载的哈希,用密钥加签是——只有签发者才能生成
负载是编码过的,不是加密过的。 任何拿到令牌的人都能解码它,读到每一条声明——你的用户 ID、你的邮箱、你的管理员标志。永远不要把密码、密钥或敏感个人数据放进 JWT。如果负载必须保密,你需要的是 JWE(加密的 JWT),而不是普通的 JWT。

签名与验证如何工作

要生成签名,签发者取 base64url(header) + "." + base64url(payload) 并对它签名:

HMAC-SHA256(secret, header + "." + payload)   // HS256: shared secret
RS256: sign with a private key, verify with a public key

验证是同样的计算反过来做:服务器用自己的密钥对收到的头部和负载重新计算签名,再比对。如果负载中哪怕一个字符被改过——比如把 "admin": false 改成 true ——签名就对不上了,令牌会被拒绝。

有两类算法值得了解。 对称式(HS256):用同一个共享密钥签名和验证——简单,但拿到密钥的人都能伪造令牌,所以只有签发者能持有它。 非对称式(RS256/ES256):私钥签名,公钥验证——验证者可以是另一个服务,这就是“用 Google 登录”这类联合登录的工作方式。

标准声明

声明含义为什么重要
iss签发者——谁创建了这个令牌拒绝陌生人签发的令牌
sub主题——这是谁的令牌(用户 ID)应用据此行事的身份
aud受众——令牌是给哪个服务的防止一个应用的令牌被拿到另一个应用里用
exp过期时间——此后令牌失效的 Unix 时间限制令牌被盗后的损失
iat签发时间发现密码修改之前签发的令牌
nbf生效时间之后才生效的令牌

除此之外,应用还会添加自己的声明——角色、权限、显示名称。请保持负载小巧:令牌每次请求都会发送,所以一个 5 KB 的令牌就是每次调用都要交的税。

什么时候用 JWT——什么时候不用

当验证必须在不查询数据库的情况下完成,或者跨越不共享会话存储的服务时,JWT 就大放异彩:API、微服务和单点登录。验证者只需要密钥。

它在一个重要方面会输: 你没法轻易撤销它。 服务器端会话可以在用户登出或修改密码的瞬间删除;JWT 在过期之前一直有效,因为没有什么东西可删。标准的缓解措施是设置很短的过期时间(按分钟算,而不是按天),再加上刷新令牌——一种只发给登录端点、用来换取新的短期 JWT 的长期令牌——或者用撤销列表,但那又悄悄把 JWT 本想避免的数据库查询带回来了。

经验法则:如果你只有一个应用和一个数据库,经典的会话 cookie 更简单、更安全。当你有多个服务,或者令牌必须跨越信任边界时,再用 JWT。

常见错误

  • 信任客户端解码出的令牌。 解码什么都证明不了——只有签名验证才算数。解码出的负载里的 admin: true 只是一项声明,不是事实——只有签名验证通过后才算数。
  • 接受 alg: none. 未签名的令牌必须拒绝。至今仍接受它的库,是 JWT 历史上最古老的漏洞——而且现在还会出现。
  • 密钥太弱或已泄露。 用 HS256 加上密钥 secret 几秒钟就能伪造。请使用足够长、随机的密钥,定期轮换,绝不要把它提交进代码库。
  • 没有过期时间(exp). )。被盗的令牌就永远有效。请设置一个较短的 exp ,并使用刷新令牌。
  • 把密钥放进负载里。 Base64URL 不是加密——任何人都能读。见上面的提示框。
  • 把令牌存在 localStorage 里。 任何跨站脚本(XSS)漏洞都能让攻击者读到它。HttpOnly cookie 是浏览器令牌更安全的存放处。

试一试:JWT 解码器

把一个令牌粘贴到 JWT 解码器里,看它拆分成头部、负载和人类可读的日期——这是最快理解本指南所讲结构的方法。

打开 JWT 解码器 →

继续学习

常见问题

JWT 是加密过的吗?

不是。标准的 JWT(JWS)是签名的,不是加密的——负载是 Base64URL,任何人都能解码。加密是另一种独立的格式 JWE,用于内容本身必须保密的场景。

用户登出时,我如何撤销 JWT?

你没法直接删除它——它在 exp 到期之前一直有效。实际可行的办法是:短期过期加刷新令牌,或者在服务器端维护一个已撤销令牌 ID(jti 声明)的黑名单,在敏感接口上检查。

JWT 和会话 cookie——我该选哪个?

单个应用加数据库,选会话 cookie:更简单、可即时撤销。API 和微服务,验证者无法共享会话存储,或者令牌要跨越服务边界时,选 JWT。很多系统两者都用:浏览器用会话,服务间调用用 JWT。

JWT 在浏览器里应该存在哪里?

存在 HttpOnly、Secure、SameSite 的 cookie 里——JavaScript 读不到它,所以 XSS 偷不走。localStorage 很方便,但页面上的任何脚本都能读,包括被注入的脚本。

没有密钥能解码 JWT 吗?

可以——解码头部和负载完全不需要密钥;只有验证签名才需要。这就是为什么 JWT 解码器工具能立刻显示令牌内容,也是为什么你绝不能把密钥放进负载里。