JWT 看起来像一串随机字符,其实结构非常直白:三段 Base64URL,用点连接。真正容易出问题的不是解析,而是「解析成功」带来的错觉——任何人都能读出 Payload,但只有持有密钥的服务端才能验证它没有被改过。

三段分别是什么

header.payload.signature
  • Header:通常是 {"alg":"HS256","typ":"JWT"},声明签名算法和类型。
  • Payload:一组 claims,例如 sub、iat、exp、role。它是明文可读的,不要放密码、身份证号或内部密钥。
  • Signature:对前两段做签名后的二进制值,再 Base64URL 编码。它不是 JSON,所以解析不出内容很正常。

把令牌粘贴到 JWT 解析工具,可以直接看到 Header、Payload 和过期状态;输入密钥或公钥后,还可以在本地校验签名。

几个关键时间字段

  • iat(issued at):签发时间,秒级 Unix 时间戳。
  • nbf(not before):在此之前令牌无效。
  • exp(expiration):过期时间。服务端必须检查,客户端检查只能改善体验,不能作为安全边界。

时间戳都是 UTC 秒数。调试时发现「明明没过期却失效」,先确认服务器时间是否同步,再检查时区是否被错误地加减了 8 小时。

HS、RS、ES 有什么区别

HS256/384/512 使用同一把 HMAC 密钥签名和验签,适合单体服务或可信的内部服务;密钥一旦泄露,任何人都能伪造令牌。RS256/384/512 用私钥签名、公钥验签,适合把验签能力交给多个服务;私钥必须只留在签发方。ES256/384/512 使用 ECDSA,签名更短,但实现和密钥格式更容易踩坑。

算法不是越新越好,关键是签发方和验签方约定一致,并且拒绝 none 或客户端临时切换算法。工具里的验签会读取 Header 的 alg,再要求你提供对应类型的密钥/公钥。

服务端应该验证什么

  1. 算法:只接受预期的算法,拒绝 none,也拒绝客户端在 Header 里随意切换算法。
  2. 签名:使用密钥或公钥验证,不能只做 Base64 解码。
  3. 时间:检查 exp 和 nbf,允许少量时钟偏差。
  4. 签发方与受众:校验 iss、aud,避免把给 A 服务的令牌拿去访问 B 服务。
  5. 吊销:JWT 本身无状态,退出登录或封禁需要短过期时间配合黑名单/版本号。

三个常见误区

把 JWT 当加密。 Payload 只是 Base64URL,不是加密。需要保密时应该使用 JWE,而不是普通 JWS。

把令牌放在 localStorage。 任何 XSS 都能读走它。更稳妥的做法是 HttpOnly、Secure、SameSite 的 Cookie,并配合 CSRF 防护。具体选择取决于前后端架构,没有一刀切的答案。

过期时间设得太长。 七天的访问令牌一旦泄露,攻击窗口就是七天。常见做法是短访问令牌加可撤销的刷新令牌。

调试时的顺序

  1. 先确认三段数量是否正确,Base64URL 是否被换行或空格污染。
  2. 解码 Header,确认算法与服务端配置一致。
  3. 解码 Payload,检查 exp、nbf、aud 是否符合预期。
  4. 最后才怀疑签名密钥、时钟和网关是否改写了 Authorization 头。

把顺序固定下来,能避免在「令牌到底有没有过期」这种问题上反复猜。

自己生成测试 JWT

调试网关、 mock 服务或前端登录时,经常需要一个可控的测试令牌。切到 JWT 工具的「生成 JWT」,填写 Payload 和密钥,选择 HS256/384/512,或粘贴 PKCS#8 私钥生成 RS/ES 令牌,就能在浏览器本地签发。生成结果只包含 Header、Payload 和签名,不包含密钥;不要把生产密钥贴进任何在线页面。

如果要验证 RS/ES 令牌,把签发方提供的 SPKI 公钥 PEM 粘贴到「校验签名」的密钥框;工具不会向服务器发送密钥或 token。

Toolbox 编辑部

关注在线工具、图片处理与本地优先的软件。