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,再要求你提供对应类型的密钥/公钥。
服务端应该验证什么
- 算法:只接受预期的算法,拒绝
none,也拒绝客户端在 Header 里随意切换算法。 - 签名:使用密钥或公钥验证,不能只做 Base64 解码。
- 时间:检查
exp和nbf,允许少量时钟偏差。 - 签发方与受众:校验
iss、aud,避免把给 A 服务的令牌拿去访问 B 服务。 - 吊销:JWT 本身无状态,退出登录或封禁需要短过期时间配合黑名单/版本号。
三个常见误区
把 JWT 当加密。 Payload 只是 Base64URL,不是加密。需要保密时应该使用 JWE,而不是普通 JWS。
把令牌放在 localStorage。 任何 XSS 都能读走它。更稳妥的做法是 HttpOnly、Secure、SameSite 的 Cookie,并配合 CSRF 防护。具体选择取决于前后端架构,没有一刀切的答案。
过期时间设得太长。 七天的访问令牌一旦泄露,攻击窗口就是七天。常见做法是短访问令牌加可撤销的刷新令牌。
调试时的顺序
- 先确认三段数量是否正确,Base64URL 是否被换行或空格污染。
- 解码 Header,确认算法与服务端配置一致。
- 解码 Payload,检查
exp、nbf、aud是否符合预期。 - 最后才怀疑签名密钥、时钟和网关是否改写了 Authorization 头。
把顺序固定下来,能避免在「令牌到底有没有过期」这种问题上反复猜。
自己生成测试 JWT
调试网关、 mock 服务或前端登录时,经常需要一个可控的测试令牌。切到 JWT 工具的「生成 JWT」,填写 Payload 和密钥,选择 HS256/384/512,或粘贴 PKCS#8 私钥生成 RS/ES 令牌,就能在浏览器本地签发。生成结果只包含 Header、Payload 和签名,不包含密钥;不要把生产密钥贴进任何在线页面。
如果要验证 RS/ES 令牌,把签发方提供的 SPKI 公钥 PEM 粘贴到「校验签名」的密钥框;工具不会向服务器发送密钥或 token。