JWT 是什么?一文讲清 JSON Web Token

JWT 是什么:JSON Web Token 里装了什么、签名怎么工作、服务端应该怎样校验,以及会让 JWT 登录变得不安全的常见错误。

阅读约 3 分钟

JSON Web Token(JWT)是一种紧凑的格式,用来在双方之间传递带签名的声明,最常见的用法是登录服务器把它发给 API。它由 RFC 7519 定义。很多人第一次问 jwt是什么,这篇指南就讲清楚令牌里有什么,以及怎样安全地使用它。

JWT 长什么样

JWT 由三段 Base64URL 编码的内容组成,用点连接:header.payload.signature。

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyLTQyIiwibmFtZSI6IkFkYSBMb3ZlbGFjZSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwfQ.BLOj0btUSBnqiL320_su23pu-WGRe-boU4wX-OBdzDI

把它粘贴到 JWT 解码 工具里,就能看到前两段对应的 JSON:

{ "alg": "HS256", "typ": "JWT" }
{ "sub": "user-42", "name": "Ada Lovelace", "iat": 1767225600, "exp": 1767229200 }

第三段是签名。这个例子用 HMAC-SHA256 和一个演示用的密钥生成。

头部(header)

头部说明令牌是怎么签名的。alg 是签名算法,比如 HS256(基于 SHA-256 的 HMAC)或 RS256(基于 SHA-256 的 RSA 签名)。typ 一般是 JWT。kid(密钥 ID)用来在轮换密钥时告诉服务端该用哪把密钥校验。

载荷(payload)和声明

载荷里放的是关于用户和令牌本身的声明(claims)。RFC 7519 登记了几个标准名称:

声明 含义
iss 签发方:谁创建了这个令牌
sub 主体:令牌指向谁,通常是用户 ID
aud 受众:令牌是给哪个服务用的
exp 过期时间:超过这个时间就拒绝
nbf 生效时间:早于这个时间就拒绝
iat 签发时间:令牌是什么时候创建的
jti 令牌 ID:唯一标识,可以用来单独吊销某个令牌

时间都是以秒为单位的 Unix 时间戳。例子里的 iat 是 2026 年 1 月 1 日 0:00(UTC),exp 是一小时之后。用 Unix 时间戳转换 工具可以把它们换成日期。

签名

服务端对 header.payload 计算签名:

  • 用 HS256 等 HMAC 算法时,签名和校验用的是同一个密钥。所有需要校验令牌的服务都必须知道这个密钥。
  • 用 RS256、ES256 等公钥算法时,私钥签名、公钥校验。API 能校验令牌,但没法自己造令牌。

签名能证明头部和载荷没有被篡改,但不能隐藏它们。Base64URL 只是编码,不是加密,拿到令牌的人都能读出载荷,用 Base64 编码 / 解码 工具就能验证。千万不要把密码或其他敏感信息放进 JWT。

服务端应该怎样校验令牌

  1. 用你预期的算法和密钥校验签名。不要让令牌头部的 alg 来决定用什么算法,并且拒绝 none。
  2. 如果 exp 已过或 nbf 未到,就拒绝令牌。可以留出 30–60 秒的时钟误差。
  3. 检查 iss 和 aud 是否和你的签发方、你的服务一致。
  4. 以上都通过之后,才能信任 sub 和其他声明。

大多数库都同时提供“只解码”和“校验”两种函数,一定要用校验的那个。

常见错误

  • 接受 alg: none。 没有签名的令牌绝不能放行。
  • 算法混淆。 如果服务端同时接受 RS256 和 HS256,又把 RSA 公钥当成 HMAC 密钥来用,知道公钥的攻击者就能伪造令牌。要把算法固定下来。
  • HMAC 密钥太弱。 只要拿到一个令牌,就能离线暴力破解 HS256 的密钥。按 RFC 7518 对 HS256 的要求,至少使用 256 位的随机密钥。
  • 令牌有效期太长。 JWT 在过期之前一直有效,退出登录也不会让它失效。访问令牌要短(几分钟),配合刷新令牌使用;如果需要提前吊销,就维护一份 jti 黑名单。
  • 把令牌存在脚本能读到的地方。 放在 localStorage 里的令牌,一旦网站有 XSS 漏洞就可能被偷走。用带 HttpOnly 和 Secure 的 Cookie 可以防止脚本读取,但要另外做好 CSRF 防护。

用 JWT 还是会话 Cookie?

传统的会话在 Cookie 里只放一个随机 ID,数据存在服务端,所以退出登录会立刻生效。JWT 自带数据,API 不用查数据库就能校验,适合多个服务或多家公司共同信任同一个登录的场景。如果只有一个 Web 应用,会话 Cookie 往往更简单,也更安全。

动手试试

理解 jwt是什么 最好的方式就是动手解码。把令牌粘贴到 JWT 解码 工具里,就能看到头部、载荷和过期时间。解码在你的浏览器里完成,令牌不会被发送到任何地方。