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。
服务端应该怎样校验令牌
- 用你预期的算法和密钥校验签名。不要让令牌头部的
alg来决定用什么算法,并且拒绝none。 - 如果
exp已过或nbf未到,就拒绝令牌。可以留出 30–60 秒的时钟误差。 - 检查
iss和aud是否和你的签发方、你的服务一致。 - 以上都通过之后,才能信任
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 解码 工具里,就能看到头部、载荷和过期时间。解码在你的浏览器里完成,令牌不会被发送到任何地方。