toolgarden.xyz
EN
JWTTokenBase64URL认证

JWT 是什么?怎么安全查看 Header、Payload 并验证签名

用一个真实 token 逐段拆解 JWT:Base64URL 解码 Header 和 Payload、判断 exp 是否过期、用 HS256 验证签名,并讲清哪些信息不能放进去、哪些攻击要防。

ToolGarden 推荐的工具优先在浏览器本地运行,文件和文本不必上传到服务器,适合更注重安全隐私的日常处理。

发布于 2026年7月2日更新于 2026年10月14日约 11 分钟作者 ToolGarden

接口调试时,你会经常碰到一长串 eyJ 开头的字符串,它们就是 JWT。很多人第一次把它粘贴进解码工具时会吃一惊:用户信息、过期时间全部明文可见。这是因为 JWT 的前两段只是编码,不是加密。本文用一个完整的示例 token,一步步演示怎么拆解它、判断是否过期、验证签名,以及应当避免的几个安全误区。

JWT 的结构:三段,用点号分隔

JWT(JSON Web Token,RFC 7519)由三段 Base64URL 文本拼成,格式是 header.payload.signature。下面是本文用来演示的 token(仅用于演示,密钥为 demo-secret):

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzg0MjEiLCJuYW1lIjoiQWRhIExvdmVsYWNlIiwicm9sZSI6ImVkaXRvciIsImlhdCI6MTc2MDQwMDAwMCwiZXhwIjoxNzYwNDAzNjAwfQ.32Ly9jxuicwBIgniALk2geoD2re8juuisCtiVCsT834
段内容示例解码结果
Header签名算法 alg 和令牌类型 typ{"alg":"HS256","typ":"JWT"}
Payload声明(claims):用户标识、角色、时间等{"sub":"user_8421","name":"Ada Lovelace","role":"editor","iat":1760400000,"exp":1760403600}
Signature对前两段用密钥计算出的签名二进制数据,Base64URL 编码后为 43 个字符

Base64URL:为什么前两段能被直接读出来

Base64URL 是 Base64 的 URL 安全变体:把 + 换成 -,把 / 换成 _,并省略末尾的 = 填充。它的目的是让 token 能放进 URL、Cookie 或 HTTP 头而不需要额外转义,并不提供任何保密性。

原文:{"a":">>>???"}
Base64     :eyJhIjoiPj4+Pz8/In0=
Base64URL  :eyJhIjoiPj4-Pz8_In0

解码时反过来:把 - 换回 +,把 _ 换回 /,补齐 = 到长度为 4 的倍数,再做 Base64 解码并按 UTF-8 解释。含有中文的 payload(如 {"name":"张三"})编码后是 eyJuYW1lIjoi5byg5LiJIn0,必须按 UTF-8 解码才不会乱码,JWT 解析页面已经处理了这一点。你也可以在信息编码转换页面手动做 Base64 解码,自己验证一遍。

逐步解码示例 token

  1. 按 . 切成三段,必须正好三段,否则不是合法的 JWS 格式 JWT。解析页面在段数不对时会提示“应包含三段”。
  2. 对第一段解码得到 {"alg":"HS256","typ":"JWT"},说明使用 HMAC-SHA256 签名。
  3. 对第二段解码得到 payload。注意 iat 和 exp 是以秒为单位的 Unix 时间戳,而不是毫秒。
  4. iat 为 1760400000,对应 2025-10-14 00:00:00 UTC;exp 为 1760403600,对应 2025-10-14 01:00:00 UTC,也就是有效期恰好 1 小时(3600 秒)。
  5. 页面会用当前时间与 exp 比较并给出“已过期”或“有效”的标记。由于这个示例 token 的过期时间早已过去,你会看到过期提示,这也是用来练习判断的好样本。

常见 claim 速查

claim含义注意
iss签发者服务端应校验是否为预期签发方
sub主体,通常是用户 ID不要放邮箱、手机号等个人信息
aud受众,令牌给谁用防止 A 服务的 token 被拿去访问 B 服务
exp过期时间(秒级时间戳)服务端必须校验;客户端的判断仅用于体验
nbf生效时间在此之前令牌无效
iat签发时间可用于判断令牌年龄
jti令牌唯一标识用于吊销或防重放,可用 UUID

验证签名:HS256 是怎么算的

HS256 的签名是 HMAC-SHA256(密钥, header.payload),其中 header.payload 是原样的两段 Base64URL 文本(包含中间的点号),算出的字节再做 Base64URL 编码得到第三段。验证时用同样的密钥重新计算,并与 token 里的第三段比较。

在 JWT 解析页面的验证区域输入密钥并点击验证,页面使用浏览器的 Web Crypto API 完成运算,会显示“签名有效”或“签名无效”。对示例 token 输入 demo-secret 会得到有效;把密钥改成任何其他值,或者把 payload 里的 role 从 editor 改成 admin 再用原签名验证,都会得到无效。这正是签名的意义:任何对前两段的篡改,都会使签名对不上。

需要明确的限制:页面只支持 HS256 这种对称算法的验证,不支持 RS256、ES256 等使用公私钥的算法;它验证的是“签名是否与密钥匹配”,不代替服务端对 exp、iss、aud 的校验;解码本身也不会验证任何东西。

Payload 里不能放什么

因为 Payload 谁都能解码,所以不能放:密码、API 密钥、身份证号、银行卡号、完整手机号等敏感数据。应当只放最小必要的标识信息,如用户 ID、角色、租户 ID 和时间。如果确实需要保密传输,应使用 JWE(JSON Web Encryption),或者把敏感信息留在服务端,令牌只携带一个不透明的引用。

JWT 常见安全坑

问题说明防范
alg 为 none攻击者把 header 的 alg 改成 none 并去掉签名,服务端如果接受就会放行服务端固定允许的算法列表,拒绝 none
算法混淆服务端用 RS256 的公钥当作 HS256 的密钥来验证,攻击者就能用公钥伪造签名按密钥类型强制指定算法,不信任 token 自带的 alg
只解码不验证前端读到 payload 就当真,比如据此展示管理员菜单权限判断一律在服务端验证签名后进行
令牌泄漏到日志URL 参数、访问日志、监控系统里留下完整 token不要把 token 放进 URL;日志里做脱敏
有效期过长令牌一旦泄漏,攻击者在有效期内一直有效访问令牌设短有效期,配合刷新机制
无法主动吊销JWT 无状态,签发后默认无法撤销维护黑名单或 jti 记录,或缩短有效期

排查“token 无效”的顺序

  1. 先看段数:不是三段,多半是复制时漏了一截,或者带着 Bearer 前缀、引号、换行。
  2. 解码 Header,确认 alg 与服务端期望一致。
  3. 解码 Payload,核对 exp 是否已过期,注意是秒而不是毫秒;再检查 iss、aud 是否与服务端配置一致。
  4. 服务器与客户端时间差:几分钟的时钟偏差就可能让 nbf 或 exp 判断出错,服务端通常会留出少量时间容差。
  5. 最后才验证签名:确认使用了正确环境的密钥,生产与测试环境密钥不同是最常见原因。

实战:篡改 payload 后签名为什么会失败

理解签名最直观的办法是亲手改一次。把示例 token 的第二段解码,把 role 从 editor 改成 admin,再重新做 Base64URL 编码,替换回原 token 的第二段,第一段和第三段保持不动。然后把这个新 token 粘贴到 JWT 解析页面:解码会成功,Payload 里清清楚楚显示 role 为 admin,但在验证区输入 demo-secret 后,结果是“签名无效”。

原因是第三段签名是用原来的两段文本算出来的。你改动了第二段,等于改变了被签名的内容,服务端重新计算得到的签名就和 token 里携带的不一样。攻击者要想让改动后的 token 通过验证,就必须知道密钥重新签名,这就是密钥必须保密的原因。这个小实验也说明了一件事:解码成功只说明格式正确,绝不等于内容可信。

  • 只改 Header 或只改 Payload,签名都会失效。
  • 把整段 token 重新编码但内容不变,只要文本不同(比如多了填充等号),在严格实现里也可能验证失败。
  • 带有 Bearer 前缀的请求头值要先去掉前缀,否则会被判断为段数不对或解码失败。

用命令行交叉验证签名

不想完全依赖网页时,可以用 openssl 自己算一遍,理解 HS256 的细节。对示例 token 的前两段(保持原样,包含中间的点号)执行:

printf '%s' 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzg0MjEiLCJuYW1lIjoiQWRhIExvdmVsYWNlIiwicm9sZSI6ImVkaXRvciIsImlhdCI6MTc2MDQwMDAwMCwiZXhwIjoxNzYwNDAzNjAwfQ' \
  | openssl dgst -sha256 -hmac 'demo-secret' -binary \
  | base64 | tr '+/' '-_' | tr -d '='

输出是 32Ly9jxuicwBIgniALk2geoD2re8juuisCtiVCsT834,与 token 第三段完全一致。这里有两个容易写错的细节:第一,要用 printf 而不是 echo,因为 echo 会在末尾多加一个换行,签名就对不上;第二,Base64 之后要把 + 和 / 换成 - 和 _,并去掉 =,才是 Base64URL。把这条命令跑通一次,你对“签名到底签了什么”就不会再有疑惑:它签的是前两段文本本身,而不是解码后的 JSON。

JWT 和服务端会话的取舍

维度JWT(无状态令牌)服务端会话(Session)
服务端存储不需要保存每个令牌需要保存会话数据,多实例需共享存储
横向扩展任何实例都能验证,只要有密钥需要会话共享或粘性路由
主动吊销困难,需要黑名单或缩短有效期直接删除会话即可
载荷体积每次请求携带完整令牌,信息越多越大只携带一个短的会话 ID
信息可见性载荷对持有者可读数据留在服务端
适合场景跨服务传递身份、短期授权需要强制下线、频繁变更权限的后台系统

常见的折中设计是:访问令牌用 JWT,有效期很短(例如几分钟到十几分钟),刷新令牌是一个不透明的随机字符串并保存在服务端,可以随时吊销。这样既享受了无状态验证的便利,又保留了吊销能力,代价是需要实现刷新流程。

排查时还有一个提醒:不要在前端用 exp 的判断结果去决定“是否信任这个用户”。前端读取 exp 只适合做体验优化,例如在令牌快过期时提前刷新,或者提示用户重新登录。真正的放行与拒绝,必须由服务端在验证签名、过期时间、签发者和受众之后做出。把这条界线划清楚,能避免大多数与 JWT 相关的安全事故,也能让你在排查问题时少走弯路。

什么时候不该用 JWT,或不该只靠这个页面

  • 需要即时吊销的场景(如强制下线):服务端会话更直接,JWT 需要额外的黑名单机制。
  • 要存放敏感用户数据:JWT 默认不加密,应使用服务端存储或 JWE。
  • 要验证 RS256、ES256 等非对称签名:这个页面不支持,请使用你所用语言的 JWT 库。
  • 要作为正式的鉴权依据:任何网页工具的结果只用于排查,鉴权必须由服务端完成。

常见问题

Q.JWT 的 Payload 是加密的吗?可以放密码吗?

不是加密,只是 Base64URL 编码,任何拿到 token 的人都可以解码读取。不要放密码、密钥、证件号或完整银行卡号。如果必须保密传输,使用 JWE,或者只在 token 里放不透明的标识。

Q.JWT 解码需要密钥吗?

不需要。解码只是还原 Base64URL 文本,任何人都可以做。密钥只用于验证签名,证明内容没被篡改且由持有密钥的一方签发。

Q.exp 是秒还是毫秒?

JWT 标准里的时间(exp、iat、nbf)是以秒为单位的 Unix 时间戳。把它当毫秒处理会得到 1970 年 1 月的日期。可以用时间戳转换页面确认。

Q.为什么签名验证失败,但 token 看起来是对的?

常见原因是密钥不对(环境混淆)、密钥里有多余空格或换行,或 token 在传输中被改动。另外,如果 alg 不是 HS256(比如 RS256),这个页面无法验证。

Q.Base64 和 Base64URL 有什么区别?

Base64URL 把 + 换成 -,把 / 换成 _,并省略末尾的 = 填充,使得结果可以直接放进 URL 和 HTTP 头。内容的保密性没有任何区别。

Q.在网页里解码 JWT 安全吗?

解析页面在浏览器本地运行,不需要上传 token。但 token 本身就是凭证,粘贴到任何地方都要谨慎:优先使用测试环境的 token,避免把生产令牌放进截图或共享的屏幕里,处理完及时清理剪贴板。