这个工具做什么
JWT 是 JSON Web Token 的缩写,是接口鉴权、单点登录、开放平台回调里非常常见的一种令牌格式。它的字符串由三段组成,中间用英文句点分隔,形式是 header.payload.signature。第一段 header 描述这个令牌用什么算法签名、类型是什么;第二段 payload 存放业务声明,例如用户标识、签发时间、过期时间、权限范围;第三段 signature 是对前两段的签名结果。前两段都是 Base64URL 编码的 JSON,本身没有加密,只是换了一种写法,因此任何人都能解码看到里面的内容。
这个工具做的事情很单纯:把粘贴进来的 JWT 按句点拆开,对 header 和 payload 做 Base64URL 解码,再用 UTF-8 还原成文本,最后用两空格缩进把 JSON 格式化,方便逐字段阅读。它还会把 payload 里的 iat、nbf、exp 换算成本地时间,并告诉你距离过期还有多久或者已经过期多久;如果令牌里没有 exp,会明确写出「未设置过期时间」。签名段只统计长度、说明是否存在,不会尝试校验。
需要特别说明的是,解码和验签是两件完全不同的事。解码只是把编码还原,不需要任何密钥;验签需要签名密钥或对应的公钥,还要按算法重新计算摘要并比对。本页面完全在浏览器里运行,没有你的密钥,也没有可信的公钥来源,所以它无法判断这个令牌是不是被伪造过、内容有没有被篡改。页面顶部和正文都反复提示这一点,请不要把「解析成功」理解成「令牌有效」。
怎么用
把完整的 JWT 粘贴到输入框即可。粘贴后稍等片刻会自动解析,也可以点「解析」按钮立即执行。输入框允许一行或多行,工具会忽略首尾空白、空格和换行,所以从日志、终端或聊天窗口复制时被折行的令牌也能直接使用。解析成功后,Header 与 Payload 会分别显示在左右两块等宽区域里,桌面端并排,窄屏时自动上下排列。
- 解析:立即重新读取输入框内容并解码,适合粘贴后想马上确认结果的场景。
- 清空:清除输入、解码结果和解读信息,方便换一个令牌继续查看。
- 复制 Header:把格式化后的 header JSON 写入剪贴板,保留缩进与换行。
- 复制 Payload:把格式化后的 payload JSON 写入剪贴板,便于贴到工单、文档或调试记录里。
输入为空时会提示粘贴 JWT;段数不对、Base64URL 含非法字符、解出的内容不是 JSON 对象、输入超过十万字符,都会在状态条给出明确的中文说明,并停止解析。出错时结果区会被清空,避免把上一次的旧结果误当成这一次的输出。
解析结果怎么读
Header 里最常见的是三个字段。alg 表示签名算法,typ 一般固定为 JWT,kid 用来标识服务端应该用哪一把密钥来验签。看到 alg 时要留意具体取值:HS256、HS384、HS512 是对称算法,签名和验签使用同一个密钥;RS256、RS384、RS512 是 RSA 非对称算法,私钥签名、公钥验签;PS256 系列是 RSA-PSS;ES256、ES384、ES512 是椭圆曲线算法;EdDSA 是 Edwards 曲线签名;none 表示不签名,任何正常服务都不应该接受它。
Payload 里的声明分成两类。一类是标准声明:iss 表示签发者,sub 表示主体,通常是用户标识;aud 表示接收方;exp 是过期时间;nbf 是最早生效时间;iat 是签发时间;jti 是令牌唯一编号。另一类是业务自定义字段,例如角色、租户、权限列表、邮箱、手机号。标准声明里的三个时间字段都是 Unix 时间戳,单位是秒而不是毫秒,本工具会把它们换算成浏览器所在时区的本地时间,并在 exp 后面追加「距过期还有」或「已过期」的时长。
时间判断有一个前提:浏览器的系统时间要基本准确。如果本机时间比真实时间快了几个小时,工具会提前显示已过期;如果慢了几个小时,则会显示还有剩余时间。服务端通常允许一定的时钟偏差,常见配置是几十秒到几分钟,但具体策略由服务端决定,页面上的判断只能作为参考。
签名段只展示长度和是否存在。签名长度和算法有关,HS256 的结果经 Base64URL 编码后通常四十多个字符,RS256 因为密钥更长,签名段会明显更长。长度只能说明「这里有一段内容」,既不能证明它由合法密钥生成,也不能证明前两段没有被改过。想要真正验证,必须把令牌交给持有密钥或公钥的服务端程序。
常见的几种情况
提示段数不是三段
这通常说明粘贴的内容不是 JWT。有些系统传的是普通随机字符串、会话 ID、OAuth 的 opaque token,它们本来就没有 header 和 payload;也有些内容在复制时被截断,只剩下一段或两段。请回到签发方确认令牌格式,不要手工补句点。JWE 是另一种情况,它是加密令牌,通常有五段,虽然也叫 JWT 家族,但 payload 是密文,本工具不能解密。
提示解出的内容不是合法 JSON
如果段数正确但 JSON 解析失败,常见原因有三个:第一,这其实是 JWE,前两段不是明文 JSON,而是加密或压缩后的数据;第二,复制时混入了多余字符,或者把 Base64 与 Base64URL 搞混;第三,令牌本身已经损坏。可以先用 Base64 工具单独解码第一段,看输出是不是以左花括号开头。如果是一堆不可读的二进制字符,基本可以判断不是普通 JWT。
显示已过期
exp 是服务端判断令牌寿命的主要依据。页面显示已过期,说明当前本地时间已经超过 exp,但服务端是否拒绝还取决于它自己的校验逻辑、时钟偏差容忍度和是否维护了额外的黑名单。反过来,页面显示未过期也不代表一定能用,令牌可能因为签名错误、用户被禁用、会话被注销而失效。调试时应当把时间信息和接口返回的错误码放在一起看,不要只盯着页面上的倒计时。
Base64URL 与 Base64 的区别
标准 Base64 使用加号和斜杠,并且经常用等号补齐;Base64URL 把加号换成减号、斜杠换成下划线,通常省略末尾的等号,目的是让结果能安全地放进 URL 和文件名。JWT 使用的是 Base64URL。本工具会先把减号换回加号、下划线换回斜杠,再按需补齐等号,然后解码。如果你把 JWT 的某一段直接丢给只接受标准 Base64 的工具,可能会因为字符集或长度不对而报错,这不是令牌坏了,而是编码变体不匹配。
安全边界
最重要的一条:解码成功不等于签名有效。任何人拿到一段 JWT 都能解码,也都能自己构造一个 header 和 payload 再拼上任意签名。页面没有密钥,无法重新计算签名,更无法确认签名是否来自可信的签发方。历史上有过 alg 设为 none 的攻击,也有过把 RS256 混淆成 HS256、诱导服务端把公钥当对称密钥使用的攻击,这些都不是前端解码能发现的问题。真正的校验必须在服务端完成,并且要固定允许的算法,不能盲目相信 header 里的 alg。
JWT 的 payload 虽然经过编码,但并没有加密,里面的 sub、email、角色、租户、内部接口地址、甚至手机号都可能被直接看到。不要把密钥、密码、身份证号、完整银行卡号之类的信息放进 payload,也不要把生产环境的令牌贴到不可信的在线工具、论坛、聊天群或截图中。令牌在有效期内就是一把钥匙,泄露后他人可以直接冒用你的身份,直到它过期或被服务端吊销。
本页面不发送网络请求,不写 localStorage 或 sessionStorage,也不会把内容拼进地址栏,所有解析都在当前标签页的内存里完成。但浏览器扩展、屏幕录制、剪贴板同步和共用电脑仍然可能带来额外风险。处理生产令牌时,优先在受控的开发机上操作,用完点「清空」,并尽量避免把完整令牌留在浏览历史或工单系统里。
使用限制与说明
输入上限是十万字符,超过后会直接提示超限并停止解析,避免超长文本拖慢页面。工具不保存历史记录,刷新页面后输入和结果都会消失;需要留存请自行复制到安全的位置。它不会解密 JWE,不会校验签名,也不会自动请求任何 JWKS 地址来获取公钥。payload 里的嵌套对象会随整个 JSON 一起格式化,但被转义成字符串的内层 JSON 只会作为普通字符串显示,需要时请复制出来再用 JSON 格式化工具处理。
如果你需要确认一个令牌是否真的有效,正确做法是使用服务端语言的官方库,例如 Java 的 jjwt、Node.js 的 jose、Python 的 PyJWT、Go 的 golang-jwt,并显式指定允许的算法与密钥来源。本工具适合快速查看声明内容、核对时间字段、排查「为什么这个令牌看起来不对」这类问题,不适合作为安全校验环节的一部分。