JWT是什么?JWT Token解析教程
登录失败、网关报 signature invalid 时,先分清「看得见字段」和「签名成立」。JWT 是三段文本,不是加密保险箱。
什么是JWT?
JWT(JSON Web Token)是一种把声明(claims)编码成可传输字符串的约定。常见形态是三部分,用点号连接:Header、Payload、Signature。Header 和 Payload 是 JSON,再做 Base64URL 编码;Signature 是对前两段的签名,用来发现篡改,不是用来把内容藏起来。
Base64URL 和普通 Base64 相近,但用 - _ 替换 + /,并且常常去掉 = 填充,好放进 Header 和查询参数。所以把 JWT 整段丢进文本 Base64 工具,有时能看、有时会失败——应按 JWT 规则拆三段。
Payload 里常见 sub、exp、iat、iss、aud。它们只是声明,谁都可以读。保密应靠 HTTPS 和短过期时间,而不是指望「别人看不懂这一串」。看字段请用 JWT解码,不要和验签混在一个按钮里。
为什么需要JWT?
服务之间要在无状态协议上带上「谁、什么时候过期、观众是谁」。Session 存在服务端也行,但多实例和跨服务时,把签名过的声明放在客户端更常见。网关验签通过才放行,业务服务再读 claims。
它解决的是「声明可校验」,不是「内容不可见」。把身份证号塞进 Payload,解码工具立刻能看到。敏感数据应留在服务端或加密字段里,而不是写进人人可拆的第二段。
调试时最容易混的两件事:登录失败其实是过期;或者 alg 被改成 none。前者看 exp,后者必须走验证而不是解码。解释见下面「如何解析」。
如何解析JWT Token?
把 Token 按点号拆成三段。第一段解出来应是 JSON,至少有 alg 和 typ。第二段是 claims。第三段是签名字节的 Base64URL,解码页可以显示,但显示出来不等于验证通过。
只想知道里面有什么:打开 JWT解码。它不使用密钥,因此不能证明 Token 来自你的认证服务。任何人都能造一段 Header+Payload 再填假签名。
要回答「签名对不对、过没过期」:打开 JWT验证,提供 HMAC 密钥或 PEM 公钥,核对 alg、exp、以及 iss/aud/sub。生产环境必须在服务端验,浏览器页只适合复现问题。算法 none 应直接拒绝。
解码成功不等于登录成功
HS256 用共享密钥;RS256/ES256 用私钥签、公钥验。把公钥误当 HMAC 密钥,或反过来,会得到 signature invalid。先确认 Header 里的 alg 和你手头的密钥材料是否一类。
时间问题很常见:exp 是 Unix 秒。本地时钟不准、或把毫秒当成秒,都会误判过期。对照 Unix时间戳 再看 Payload 里的数字。
不要把生产 Token 长期贴在聊天或公共电脑。解码页本地运行,但 Token 一旦泄露就可以被重放,直到过期。更系统的编码工具在 编码解码工具大全,安全向验签在 哈希安全工具大全。
相关工具
常见问题
JWT 是加密的吗?
默认不是。Header 和 Payload 只是编码,任何人都能解码。JWE 才是加密包装,和普通三节 JWT 不是同一件事。
为什么解码能看到用户 ID,验证却失败?
解码不检查签名。字段可见只说明 Base64URL 能还原 JSON。验证失败通常是密钥不对、过期、或 alg 不匹配。
alg 为 none 的 Token 能用吗?
不能当登录凭证。没有签名就无法发现篡改。验证工具应拒绝 none。
JWT 一定是三段吗?
常见登录 Token 是 JWS 三段。缺少第三段或点号数量不对,就不要当标准 JWT 去验签。
该用解码还是验证?
看字段用解码;问「能不能信」用验证。两页分开,是为了不让「JWT验证」和「JWT解码」抢同一个搜索词。