指南
离线 JWT 令牌解码、Base64URL 与语义级 JSON Diff 对比
零上传在浏览器内存中解析 JWT 头部与载荷、编码无填充 Base64URL、运行忽略键序的语义 JSON Diff 并在分享前脱敏日志令牌。
快速解答: JWT 的头部与载荷本质上只是 Base64URL 编码的 UTF-8 JSON,因此完全可以在浏览器内存中零上传解码查看 claims;排查接口变更时启用语义 JSON Diff 可自动忽略键顺序与空格差异,分享调试日志前再配合日志脱敏器清掉 Bearer 令牌。
为什么把生产环境 JWT 贴进在线解码网站是高危泄露
线上有效的 JSON Web Token 常包含用户 ID、邮箱、租户权限范围和未过期的会话凭据。只要将其粘贴进联网运行的第三方解码站,令牌就可能落入服务端的访问日志或前端统计脚本中。
实际上,JWT 的三段结构(header.payload.signature)前两段只是未加密的 Base64URL UTF-8 JSON,在本地浏览器内存即可瞬间解析。
- 遵循 RFC 4648 第 5 节的 Base64URL 会用 - 与 _ 替代 + 和 /,并省去末尾 = 填充符。
- 本地解码可直接查看 alg、typ、sub、exp 及自定义权限载荷。
- 需要特别区分:前端解码仅用于检视内容,密码学签名校验仍必须在服务端或 JWKS 验签端配合密钥完成。
在本地自动识别 JWT 与编码无填充 Base64URL 字符串
在“Base64 与 JWT 解码”的解码模式下开启 autoDetectJwt 后,只需贴入三段式 Base64URL JWT,工具便会自动提取 header、payload 与 signature 字符串并输出规整 JSON。
切换到编码模式并启用 urlSafe,即可生成无 = 填充的 Base64URL 编码,适合直接放进 OAuth state 或 URL 查询参数;解码时兼容标准 +/ 与 URL 安全 -_ 变体及 UTF-8/ASCII 字符集。
{
"header": {
"alg": "HS256",
"typ": "JWT"
},
"payload": {
"sub": "user_123",
"name": "Maya Lin",
"local": "true"
},
"signature": "dGVzdF9zaWduYXR1cmU"
}用语义 JSON Diff 替代普通按行对比排查接口差异
对比测试环境与生产环境 API 响应时,哪怕实际字段值一致,只要两端序列化输出的键顺序不同或一个压缩、一个缩进,普通逐行 Diff 就会满屏标红。在“文本 Diff 对比”中勾选 semanticJsonDiff 后,工具会先解析两侧 JSON 结构树再进行语义级比对,自动忽略键序与空格变化。
若报文来自带 // 注释或尾随逗号的 JSONC 片段,可先交由 JSON 格式化开启修复开关清洗语法;需要将 JSON 配置导出为 TOML 时,注意 TOML 规范不支持 null,JSON 转 TOML 会安全忽略 null 键并给出提示。
| 对比模式 | 对象键名重排 | 空格与压缩格式差异 | 适用场景 |
|---|---|---|---|
| 逐行 Diff(默认) | 记为删除并新增 | 未开忽略空白时会标出 | 代码补丁、.env 配置、纯文本 |
| 逐行 Diff + 忽略空白 | 记为删除并新增 | 自动忽略行内空格缩进 | YAML、SQL、Markdown 文档 |
| 语义 JSON Diff | 自动忽略键序差异 | 自动忽略排版差异 | API 响应、JWT 载荷、JSON 配置 |
分享调试日志前一键清除 JWT、IP 与数据库连接串
在本地排查完 JWT 声明或接口 JSON 差异后,如果还需要把报错堆栈或 HTTP 报文贴到工单、Slack 或 AI 对话中,切勿直接携带原始 Authorization 请求头或数据库密码串。
先通过“日志 AI 脱敏”确定性地将 JWT 替换为 [[JWT-01]]、掩码内网 IP 与 Postgres/Redis 连接地址后再对外分享。
参考资料
常见问题
Base64 与 JWT 解码工具会验证 JWT 密码学签名吗?
不会。为了避免你输入签名私钥或公钥,工具仅在本地解码 Base64URL 头部与载荷 JSON 并原样展示签名字符串;请务必在受信任的后端或认证服务中校验签名真伪。
标准 Base64 和 Base64URL 有什么核心区别?
Base64URL 会把 + 替换为 -、把 / 替换为 _,并通常省略末尾的 = 填充字符,从而让编码结果能安全地嵌入 URL 与 HTTP 头部。
为什么语义 JSON Diff 要求两侧都是合法 JSON?
因为语义对比必须先把左右两栏解析为 JSON 数据树,才能按键值而非行号比对;若片段带有注释或尾随逗号,可先用 JSON 格式化一键修复。