指南

离线 JWT 令牌解码、Base64URL 与语义级 JSON Diff 对比

零上传在浏览器内存中解析 JWT 头部与载荷、编码无填充 Base64URL、运行忽略键序的语义 JSON Diff 并在分享前脱敏日志令牌。

4 分钟阅读

快速解答: 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 字符集。

json
{
  "header": {
    "alg": "HS256",
    "typ": "JWT"
  },
  "payload": {
    "sub": "user_123",
    "name": "Maya Lin",
    "local": "true"
  },
  "signature": "dGVzdF9zaWduYXR1cmU"
}

在浏览器内存中本地解码 JWT 与 Base64URL

用语义 JSON Diff 替代普通按行对比排查接口差异

对比测试环境与生产环境 API 响应时,哪怕实际字段值一致,只要两端序列化输出的键顺序不同或一个压缩、一个缩进,普通逐行 Diff 就会满屏标红。在“文本 Diff 对比”中勾选 semanticJsonDiff 后,工具会先解析两侧 JSON 结构树再进行语义级比对,自动忽略键序与空格变化。

若报文来自带 // 注释或尾随逗号的 JSONC 片段,可先交由 JSON 格式化开启修复开关清洗语法;需要将 JSON 配置导出为 TOML 时,注意 TOML 规范不支持 null,JSON 转 TOML 会安全忽略 null 键并给出提示。

运行语义级 JSON Diff 或并排文本对比

对比模式对象键名重排空格与压缩格式差异适用场景
逐行 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 连接地址后再对外分享。

分享前自动脱敏日志中的 JWT 与密钥

参考资料

常见问题

Base64 与 JWT 解码工具会验证 JWT 密码学签名吗?

不会。为了避免你输入签名私钥或公钥,工具仅在本地解码 Base64URL 头部与载荷 JSON 并原样展示签名字符串;请务必在受信任的后端或认证服务中校验签名真伪。

标准 Base64 和 Base64URL 有什么核心区别?

Base64URL 会把 + 替换为 -、把 / 替换为 _,并通常省略末尾的 = 填充字符,从而让编码结果能安全地嵌入 URL 与 HTTP 头部。

为什么语义 JSON Diff 要求两侧都是合法 JSON?

因为语义对比必须先把左右两栏解析为 JSON 数据树,才能按键值而非行号比对;若片段带有注释或尾随逗号,可先用 JSON 格式化一键修复。

相关格式

相关方案对比

相关指南