开发辅助

JWT 解析

解析 JWT Token,查看 Header、Payload 和签名信息

🔐

粘贴 JWT Token 开始解析

JWT 由三部分组成:Header.Payload.Signature

什么是 JWT?

JWT(JSON Web Token)是一种开放标准(RFC 7519),用于在网络应用之间安全地传输信息。JWT 通常用于身份验证和信息交换。

JWT 结构

JWT 由三部分组成,用点(.)分隔:

  • Header(头部):包含 token 类型和签名算法
  • Payload(载荷):包含声明(claims),即要传输的数据
  • Signature(签名):用于验证消息的完整性

标准声明(Claims)

  • iss (Issuer):签发者
  • sub (Subject):主题/用户
  • aud (Audience):接收方
  • exp (Expiration):过期时间
  • nbf (Not Before):生效时间
  • iat (Issued At):签发时间
  • jti (JWT ID):唯一标识

常用签名算法

  • HS256:HMAC-SHA256(对称加密,共享密钥)
  • RS256:RSA-SHA256(非对称加密,公私钥对)
  • ES256:ECDSA-SHA256(椭圆曲线)

安全注意事项

  • JWT 的 payload 仅做 Base64 编码,不是加密,任何人都可以解码查看
  • 敏感信息不应放在 JWT payload 中
  • 始终验证 JWT 签名
  • 设置合理的过期时间
  • 使用 HTTPS 传输 JWT

在浏览器里把一个 JWT 紧凑令牌拆成 Header、Payload、Signature 三段,按 Base64URL 解出头部与载荷的 JSON,把 exp、iat、nbf 换算成本地时间并附上相对时间,再按本机时钟判定有效或过期。适合排查接口刚返回 401 时,那枚令牌里究竟装了什么。

三段 Base64URL,只有两段是 JSON

JWS 紧凑序列化(RFC 7515 §7.1,JWT 在 RFC 7519 §7.1 沿用)用点号拼接三段:BASE64URL(header) + "." + BASE64URL(payload) + "." + BASE64URL(signature),每段都去掉了 = 填充。工具先把 - 还原成 +、_ 还原成 /,补齐填充位再交给 atob,之后 JSON.parse 才拿到真正的字节;两段 JSON 都按 UTF-8 解释,载荷里一个汉字占三字节。第三段性质完全不同,它承载的是原始签名字节,永远解析不成 JSON——内置示例里 43 个字符正好还原出 32 字节,等于一个 SHA-256 摘要。去掉填充的 Base64URL 段长不可能出现「除以 4 余 1」,一旦出现就是被截断或多拷了字符。

签名长度可以指纹出算法

第三段是定长签名的去填充 Base64URL,所以光看长度就能猜出算法族。HMAC-SHA256 是 32 字节、43 字符;HS384 是 48 字节、64 字符;HS512 是 64 字节、86 字符。RS256 与 PS256 输出的都是模长:2048 位密钥为 256 字节、342 字符,4096 位为 512 字节、683 字符。ES256 固定 64 字节(r、s 各取 32 字节定长拼接)、86 字符,而 OpenSSL 风格的 DER 签名有 70 到 72 字节且以 0x30 开头,把 DER 字节直接塞进 JWS 会得到一个看起来完整、却谁都验不过的令牌。光靠长度分不出 RS256 与 PS256,只能看 alg;本工具对这一段的处理只是原样展示。

exp、iat、nbf 都是秒,而且只比较 exp

RFC 7519 §2 的 NumericDate 是自 1970-01-01T00:00:00Z 起算的秒数(忽略闰秒),所以组件把每个值乘 1000 才构造 Date。载荷里写成 JavaScript 毫秒时间戳是最典型的翻车点:1516239022000 会被渲染成 50017 年,而 1.5e12 并不小于当前的 1.79e9,角标于是显示「Token 有效」。状态栏只做一次严格的 exp < now 判断,不留任何时间容差;nbf 只画成日期却不参与比较,aud、iss 也只是原样打印,没有可对照的期望值。完全没有 exp 的载荷会一直显示有效,而永不过期的访问令牌恰恰是轮换策略要消灭的东西。

实操示例

解析「加载示例」按钮里的那枚令牌

输入
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMiwiZXhwIjoxNTE2MjQyNjIyfQ.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30
输出
头部:{"alg":"HS256","typ":"JWT"}(27 字节)|载荷:{"sub":"1234567890","name":"John Doe","admin":true,"iat":1516239022,"exp":1516242622}(85 字节)|签名:43 字符 = 32 字节,以 28c505b0 开头

第一段 36 个字符的去填充 Base64URL 正好还原成 27 字节的头部 JSON;载荷段 114 个字符对应 85 字节,其中 exp 1516242622 等于 2018-01-18T02:30:22Z,早已过期,所以状态卡显示「Token 已过期」。签名段展开后是 28c505b0...577d,32 字节正是 HMAC-SHA256 的输出长度,工具只把它照原样显示,并不会拿头部与载荷重算一遍。

边界与常见误用

  • 不做任何验证:没有密钥、私钥或 JWKS 输入框,被改过载荷的令牌与真令牌解出来一模一样,签名卡片只是回显那一段字符。
  • 只接受点号分隔的三段,RFC 7516 紧凑格式的五段 JWE 会被直接判为无效;而 alg: none 的令牌末尾留一个点仍能通过分段检查,签名卡片显示为空。
  • 过期与否拿浏览器时钟做严格的 exp < now 比较且没有时钟容差,nbf 只渲染不校验,所以尚未生效的令牌照样显示有效。
  • 声明按 UTF-8 做百分号解码,字节不合法时退回 Latin-1 读取,结果是卡片照常渲染,里面却是乱码。
  • 输入预处理很死板:只识别 Bearer 加空白的前缀,文本框也没有长度上限,所以从 .env 里连引号一起拷来的令牌会直接报三段格式错误。

相关工具

出问题时先看这里

页面亮着绿勾写「Token 有效」,可接口照样回 401。

原因角标只跑一条判断:payload.exp ? payload.exp < now : false,不留任何时钟容差。整个组件里没有 secret、私钥或 JWKS 输入框,签名卡片只是把第三段原样贴出来;aud、iss、jti 都当普通字符串渲染,没有可比对的期望值。所以「有效」在这里只等于「exp 还没到」。

处理把这个角标当过期提示,而不是验证结论。要确认签名,得去有密钥的地方跑一遍:jwt.io 填 secret 或 PEM、jose 的 jwtVerify、或服务端的 jsonwebtoken.verify;再把 aud 与接口期望的受众对一遍。既然这里零容差,顺手确认浏览器和服务器时钟是否对得上秒。

载荷里明明写着 "exp": 0,角标仍然是绿的,时间信息卡里根本没有「过期时间」这一行。

原因过期判断用的是真值测试而不是「有没有这个键」,0 因此被当成「没有 exp」:isExpired 退回 false,expiresAt 保持 undefined,状态卡于是不打印日期、时间线也不渲染那一行。而载荷卡片照样把 0 乘 1000,在绿勾旁边显示 1970-01-01 08:00:00(东八区本地时间)。

处理把 exp: 0 直接读成「1970 年就过期了」,这枚令牌别再参考角标。更普遍的一条规则该写在校验端而不是这页:没有 exp 的载荷在这里永远显示有效,所以服务端必须把 exp 设为必需声明,缺失即拒。

页面上的过期时间比服务器日志里的 UTC 时间晚 8 小时,两边对不上。

原因formatDate 调的是 toLocaleString,只传了语言没传 timeZone,墙钟时间完全取自浏览器时区,而且界面上不会打出时区名。exp 本身是 UTC 秒数:1516242622 就是 2018-01-18T02:30:22Z,东八区的机器把它渲染成 10:30:22,看不出中间被平移过。

处理比数字而不是比显示出来的字符串:把 exp 和 date +%s 放一起看;或者读旁边那句相对的「x 小时前」,它不受时区影响。只有在确认这一串时间出自哪个时区之后,再去相信绝对时刻——时区来自浏览器,不来自签发方。

中文界面弹出一句英文:「JWT 解析失败:Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded」。

原因整个解码包在一个 try/catch 里,catch 只往浏览器给的异常文本前面加一句本地化前缀,异常本身仍是 DOMException 的英文措辞。atob 遇到字母表外的字符就抛错,而它之前唯一的清洗只是把 - 换 +、_ 换 / 再补填充。最常见的触发是把整行 Authorization: Bearer eyJ... 贴进来:组件只剥离开头的 Bearer 加空白,请求头名字和那个冒号会留在第一段里。

处理输入框里只放点号分隔的三段本体。异常类型本身就是诊断线索:报 atob 说明有非 Base64 字符混进段里;报 JSON.parse 的 Unexpected token 或 Unexpected end of JSON input,说明字节解得出来但这段被改过、被截断,或者干脆是空的。

从 Header 卡片复制出来的 JSON,跟令牌里原来那段字符对不上。

原因复制按钮走的是 JSON.stringify(obj, null, 2),给你的是重新序列化的产物:键顺序跟 JSON.parse 走,数字写法会被规范化(1.516239022e9 变回 1516239022),转义字符变成字符本身;同一个声明出现两次时只留最后一个,因为 JSON.parse 会覆盖前一个。

处理需要原始字节时,自己从输入框里按点号把那段切出来,卡片只用来读。遇到载荷里有重复键,别假设各方读到的是同一份:这页显示的是最后一个,所以该去确认你自己的解析器保留哪一份,而不是相信卡片。

六种情形:什么时候留在本页,什么时候该去做真正的验证

你要判断的事本页(JWT 解析)更合适的做法
手上只有一枚令牌,想马上看清里面装了什么粘进去(带不带 Bearer 前缀都行)立刻拆成三段:头部与载荷按 JSON 展开,exp、iat、nbf 换算成本地时间并附一句相对时间。不用装任何东西,也不用提供密钥——而这恰恰也是它能给出的全部。如果问题升级成「签名对不对」,就需要能填密钥的调试器:jwt.io 支持 secret、PEM 或 JWKS 地址,会直接给出 verified / invalid。本组件没有这个入口,所以它永远回答不了这一问。
令牌有五段,或者某个声明里又嵌了一枚 JWT分段是字面切分:token.split(".") 必须正好得到三段,否则整枚令牌被判「应包含三个部分」,一个字符的内容都不显示。RFC 7516 紧凑格式的 JWE 每次都落在这个分支。用 jose 的 compactDecrypt 配解密密钥,或让服务端解密后把 claims 打进日志。加密令牌本来就无法被任何解码器读出内容,声称能读的只是在猜。
拿一份日志导出,要核对几百枚令牌一次粘贴一枚。旁边的相对时间按你眼前的时钟计算,所以旧日志里的令牌只会显示「1 天前」,跟它当时是否有效毫无关系。这点活儿交给脚本,操作本身很小:取 t.split(".")[1] 解码,Node 里是 Buffer.from(seg, "base64url"),Python 里是 base64.urlsafe_b64decode(seg + "=" * (-len(seg) % 4)),再逐条比 exp 与日志行里的时间戳。脚本还留下可以重跑的 diff。
要在 CI 或服务端断言 aud、iss、exp没有任何填写期望值的输入框。aud、iss 只是普通字符串,nbf 画成日期却不参与比较,唯一被判断的只有 exp。它是查看器,没法让一枚令牌通过或失败。交给带期望参数的校验库:jsonwebtoken.verify 传 algorithms、audience、issuer,或用 jose 的 jwtVerify 配 createRemoteJWKSet 处理轮换密钥。算法白名单要显式钉死,否则算法降级这条路一直开着。
只想在自己代码里取一个 claim,不想多装依赖结果待在浏览器标签页里,还得手抄回编辑器。临时看一眼没问题,当两个系统之间的数据通道就不合适了。标准库三行就够:按点号切、把第二段补到 4 的倍数、交给 JSON 解析。本页多做的只有时间换算,而这一步你所用语言的日期库本来就会做。
怀疑算法被换过,比如 alg 被改成 none 或 HS256alg 只用来查一句说明(HS256 显示为 HMAC-SHA256(对称加密)),既不会和密钥类型比对,也没有白名单,所以被降级的令牌在这里显示得和真令牌一样平静。在校验侧强制白名单;手工核对时按 alg 暗示的密钥族重算一遍——HS* 用共享密钥,RS*、PS* 用公钥。本页能告诉你对方「声称」用了哪一族,那是这项检查的输入,不是检查本身。

常见问题

解码 JWT 等于验证 JWT 吗?
不等于。解码只是 Base64URL 加 JSON 解析,任何人都能读出载荷。验证需要用密钥校验签名,并检查 exp、nbf、iss、aud 等声明。解码成功不等于可信。
把 token 粘贴到这里安全吗?
解码完全在你的浏览器内完成,token 不会上传。但注意:JWT 载荷本身只是编码不是加密,任何拿到 token 的人都能用同样方式读取,请把它当作凭证对待。
为什么我的 token 提示无效或已过期?
最常见的原因:exp 已过、客户端与服务器时钟偏差过大,或 aud/iss 与后端配置不匹配。解码载荷后逐项与服务器配置比对。

内容复核: