开发实操 · 可复现示例

JWT 解析与过期时间排查:exp 秒/毫秒混用与 Base64URL 常见坑

系统排查 JWT 解码失败、中文乱码、exp 过期时间异常与签名校验边界,结合 JWT 解码、Base64 与时间戳工具快速定位问题。

由 DevTools 极客工具箱 维护 · 更新于

先确认:拿到的是不是完整三段式 JWS?

标准签名型 JWT(JWS)由英文点号 . 分隔的三段组成:Header.Payload.Signature。联调时最常见的“解析报错”往往不是算法坏了,而是输入中混入了额外字符:

  • 忘了去掉 HTTP 请求头里的 Bearer 前缀或首尾换行空格;
  • 复制日志时被终端自动折行截断了最后一段;
  • 拿到的是 5 段式加密令牌(JWE),普通解码器无法在没有私钥的情况下解出明文 Payload。

把清理后的三段字符串粘贴到 JWT 解码工具,即可立即分离出 Header 和 Payload JSON。

常见坑一:把 exp 写成了 13 位毫秒时间戳

根据 RFC 7519,exp(过期时间)、iat(签发时间)和 nbf(生效时间)统一定义为 NumericDate——单位是秒(10 位整数),而不是 JavaScript 的 Date.now() 毫秒数(13 位整数)。

  • 错误示例:{"exp": 1763808000000}(把毫秒当秒解释,会算出公元 57859 年才过期,导致令牌永久不过期);
  • 正确示例:{"exp": 1763808000}(10 位秒级时间戳)。

如果不确定 Payload 中的数值对应北京时间还是 UTC,可把数值直接复制到 Unix 时间戳转换工具 中核对 10 位秒与 13 位毫秒的差异。

常见坑二:手写 atob() 解码出现乱码或报错

JWT 的前两段采用 Base64URL 编码(与标准 Base64 的区别是把 + 换成 -、/ 换成 _,并去掉末尾的 = 补位)。直接把 Payload 丢进浏览器原生 atob() 往往会遇到两类问题:

  1. Payload 中包含 - 或 _ 时 atob() 直接抛出 InvalidCharacterError;
  2. Payload 里有中文昵称时,atob() 返回的是 Latin-1 字符串而非 UTF-8,需要再经 TextDecoder('utf-8') 还原。

如需单独验证某一段编码字节,可用 Base64 编解码工具 开启 URL-Safe 模式逐段核对。

安全边界:能解码 ≠ 令牌合法

JWT 的 Header 和 Payload 只是编码而不是加密,任何人拿到 Token 都可以查看里面的字段。因此:

  • 切勿把密码、手机号明文或密钥放进 JWT Payload;
  • 在线工具展示“结构有效”或“未过期”不代表签名通过;真正的 alg 白名单检查、签名校验、iss / aud 核对必须在服务端完成;
  • 排查线上问题时请使用测试环境脱敏令牌,避免将正式用户的有效会话粘贴到不受控的公共记录中。
已成功复制到剪贴板