JWT解析只是把 header 与 payload 从 base64url 还原出来,既不校验签名,也不能代替服务端的放行判断。本文讲清解码、exp 过期判断与验签的分工,并给出本地排查 token 的操作步骤。
JWT解析看到的是 token 里写了什么,不是这个 token 能不能信。在线解码把 header.payload.signature 的前两段还原成 JSON,再按 exp 与浏览器本地时间比出「已过期 / 未过期」;至于签名有没有被改过、签发方是否可信,解析结果一概不负责,这两件事必须在服务端验签才能定。
先说结论
JWT解析与验签是两件事:解码不需要密钥、谁都能做,验签需要密钥、只能由持有密钥的一方做。
- 解码只做还原:
header与payload本来就是 base64url 编码的 JSON,拿到 token 的人都能读出内容,它保护的是「不能伪造」,不是「读不出来」。 - 页面给出的「已过期 / 未过期」,是
exp声明值与浏览器本地时间的比较结果,属于排查提示,不是服务端的放行结论。 alg只是签发方写在 header 里的声明,写着HS256不代表签名真的合法;alg: none更是不签名的调试形态。- 要判断一个请求能不能放行,顺序是:先验签,再按服务端策略校验
exp、nbf、iss、aud,并明确拒绝none。 - 用 JWT加密解密 可以在浏览器本地完成解码与测试样本签发,输入不上传,适合排查字段和时间,不适合做安全判定。
为什么会这样
JWT 的结构决定了「读」和「验」天然分离。一个典型 token 是 header.payload.signature 三段,用点号分隔;前两段是 JSON 经 base64url 编码后的文本。base64url 只是把字节换成 URL 安全字符并去掉 = 填充的编码方式,不是加密,也不需要密钥,浏览器里 atob 加一次 UTF-8 解码就能还原成原始 JSON。换句话说,token 一旦出现在日志、地址栏或抓包记录里,里面的字段就等同于公开。
第三段签名才承担防篡改。以 HMAC 家族为例,签发方把 base64url(header) 与 base64url(payload) 用点号拼成待签串,再用共享密钥 secret 算 HMAC,把二进制结果同样编码成 base64url 作为第三段。校验时必须用同一把密钥重算并比对,而这把 secret 属于服务端机密;网页工具拿不到它,只能展示内容、无法判断「签名正确」。RS / ES 类改为私钥签名、公钥验签,公钥虽可公开,正式校验仍应放后端,不让前端自己决定信不信。
exp 的判定口径也容易误读。它是签发方写入 payload 的秒级 Unix 时间戳,解码工具把 exp 乘以 1000 换算成毫秒,与浏览器当前的本地时间比较,得出「已过期 / 未过期」并给出对应时刻。这里有三个边界:比较基准是本机的时钟,机器时间不准或跨时区协作时结论会偏;payload 里没有 exp 时不会给出过期结论;就算显示「未过期」,也只是签发方声明的有效期没到,是否信任由服务端策略决定。nbf(生效时间)与 iat(签发时间)同样是秒级时间戳,只提供信息,不提供授权。
既然不能定性,为什么还要解码?排查 401、字段缺失、时间算错时,得先看清 token 里写了什么:算法声明对不对、用户标识是否符合预期、exp 有没有把毫秒写成秒、粘贴时有没有多带字符。这类查看纯本地、可逆,不用把生产数据交给第三方服务。
具体怎么做
按「解码看字段 → 本地造样本 → 后端验签」三步走,就能把排查动作与安全判定分开,不互相代替。
- 打开 JWT加密解密 的「解码」页签,粘贴完整 token。带
Bearer前缀也能识别,工具会先剥掉前缀再按点号切成两段或三段;这样处理是为了避开最常见的复制误差,例如多带引号、空格、换行,或者只贴了前两段。 - 先看 header 里的
alg与typ。alg告诉你签发方声明用了什么算法,常见的有HS256、HS384、HS512;typ一般是JWT。把它当成线索而不是证据,因为 header 与 payload 一样可以被改写。 - 再看 payload 的逐字段视图。标准声明
iss、sub、aud、exp、nbf、iat、jti会逐项列出,exp会换算成本地时间并给出对应时刻,省去心算;想单独复核数值,可配合 时间戳转换 把秒级时间戳对成可读时刻。 - 读「已过期 / 未过期」提示时记住它的口径:只是
exp与本机时间的比较。若 payload 层级较深、字段挤在一起不好读,把 JSON 复制到 JSON 格式化 展开再看;复制过程中不要把真实密钥、生产凭据一起带进任何网页工具。 - 需要复现问题时切到「生成」页签造样本:选
HS256/HS384/HS512之一或none,填入 payload JSON(必须是花括号键值对对象,数组会被拒绝),再提供共享密钥。页面用浏览器自带的 Web Crypto 在本地算 HMAC 签名;自定义 header 时alg会被强制覆盖成所选算法,避免声明与实际签名不一致。调试密钥用随机生成的即可,别把生产secret粘进来。 - 把签出的 token 粘回解码页,确认字段与过期提示符合预期,再把正式校验放回后端:验签、校
exp/nbf/iss/aud,并显式拒绝alg: none。想理解「同一份内容换密钥结果就不同」这层机制,可以用 HASH 计算页 对比普通摘要与带密钥的 HMAC 结果。
参数对照
解码、过期判断、验签三者里,只有验签需要密钥,也只有验签能证明内容没有被改过。
| 动作 | 需要什么 | 能得出什么结论 |
|---|---|---|
| 解码 header / payload | 只要 token 本身 | 字段内容、alg 声明、声明的时间值,不含真伪判断 |
| 过期判断 | exp 加浏览器本地时间 |
该声明值相对当前时刻是否已过,不代表服务端是否放行 |
| 生成测试 token | payload JSON 加 HS 系共享密钥,或选 none |
得到可用于联调的样本,签名在本地算出 |
| 验签 | 服务端密钥(HMAC 的 secret,或 RS / ES 的公钥) |
签名是否由持有密钥的一方产生,内容是否被改 |
| 完整鉴权 | 验签结果加 exp / nbf / iss / aud 策略 |
这次请求能不能放行 |
常见字段的排查含义如下,读 payload 时按这张表对号入座即可。
| 字段 | 位置 / 类型 | 排查时看什么 |
|---|---|---|
alg |
header / 字符串 | 签发方声明的算法,HS256 等;none 表示不签名 |
typ |
header / 字符串 | 通常为 JWT,自定义 header 时会保留原有字段 |
exp |
payload / 秒级时间戳 | 过期时刻,与当前时间比较得到「已过期 / 未过期」 |
nbf |
payload / 秒级时间戳 | 生效时刻,早于它不应接受 |
iat |
payload / 秒级时间戳 | 签发时刻,用来估计 token 新旧 |
iss / aud / sub / jti |
payload | 签发方、受众、主体、唯一编号,由服务端策略校验 |
常见误区
多数误判都来自把「能读出来」当成「可以相信」。
- 以为解码显示「未过期」就能放行 → 实际签名没验,任何人都能改掉
exp再重新编码,只有验签能发现篡改。 - 以为 payload 是加密的,放手机号、证件号也没关系 → 实际只是 base64url,拿到 token 的人都能还原,敏感信息不要明文写入,涉及个人信息的字段按合规要求脱敏。
- 以为把生产
secret贴进网页工具方便复现 → 实际本地计算虽不上传,但生产密钥不该出现在浏览器里;测试用随机密钥,正式签发与校验放后端。 - 以为
alg: none也是正常算法 → 实际输出只有两段加空签名,服务端必须明确拒绝。 - 以为解码报错就是工具坏了 → 实际多半是段数不对或前两段不是合法 base64url JSON,例如贴了 JWE 五段密文、带了多余字符。
常见问题
下面按真实搜索里常见的问法,把几个容易卡住的点一次说清。
JWT 解码需要密钥吗?为什么在线工具不让我填 secret?
不需要。header 与 payload 是编码而非加密,解码只要按点号拆开再做 base64url 解码即可;密钥只在生成签名和校验签名时才用得到。在线解码页不提供验签,正是因为它不该拿到服务端的 secret,页面也会明确提示「解码不验签」。需要确认 token 是否有效,请在后端用密钥重算签名并比对。
exp 是秒还是毫秒?为什么工具显示的时间和后端对不上?
exp 是秒级 Unix 时间戳,工具乘以 1000 后与浏览器本地时间比较,所以显示的是本机时区下的时刻。对不上通常有三个来源:签发时把毫秒写进了 exp,浏览器所在机器时钟与服务端有偏差,或者双方看的根本不是同一个字段(把 iat 当成过期时间)。用时间戳转换页把数值折成可读时间,再和后端日志里的签发时刻对齐,很快能定位。
怎么快速造一个带过期时间的测试 JWT?
在生成页签填入 payload JSON,exp 写成当前秒数加有效期,例如一小时后就是加 3600;选好 HS256 等算法、给一把随机测试密钥,点生成得到完整 token,再粘回解码页核对。payload 必须是对象,写成数组或字符串会被拒绝;none 只用于本地调试,不要拿它模拟生产鉴权。
header 里写着 HS256,是不是就说明签名没问题?
不能说明。alg 是 header 里的一段明文声明,改它与改 payload 一样容易,历史上不少安全问题就出在服务端轻信了这个声明。正确做法是服务端按自己配置的算法与密钥验签,而不是读取 token 自带的 alg 来决定怎么校验,同时把 none 与算法混淆的情况列入拒绝名单。
在线解码会把我的 token 传上去吗?生产 token 能贴吗?
解码与生成都在浏览器本地完成,不发起携带输入内容的网络请求,密钥只在内存里参与一次计算,不落盘、不进统计。但「不上传」不等于「可以随便贴」:生产 token 常是可直接使用的凭据,别贴到共享屏幕、聊天记录或不可信的浏览器环境,排查完及时清理;涉及真实用户数据的 payload 按最小必要原则处理。
排查 token 内容时,用 JWT加密解密 在浏览器本地解码;是否放行,交给服务端验签与策略判断。