关于此工具
JWT(JSON Web Token,RFC 7519)是一种紧凑且自包含的安全通信标准,广泛用于现代分布式架构中的用户身份认证、无状态会话管理(SSO)与微服务鉴权。一个标准的 JWT 由 Header(头部)、Payload(负载)和 Signature(签名)三部分以点号(.)拼接而成。本工具提供纯前端本地实时解码,解析载荷中的用户身份、角色权限与有效时间,绝不上传 Token 数据。
如何使用本工具(操作步骤)
粘贴待解析的 JWT 字符串
将 Bearer Token 或客户端本地保存的 JWT 字符串粘贴至上方输入框,系统自动剔除多余的 'Bearer ' 前缀与空白字符。
实时查看头部与载荷结构
工具即时通过 Base64Url 规范还原 Header 与 Payload,高亮显示算法(alg)、颁发者(iss)、主体(sub)及过期时间(exp)。
检查过期状态并复制数据
系统自动将 exp 时间戳换算为可读本地时间,直观标注 Token 是否已失效,点击复制按钮可快速提取格式化后的载荷 JSON。
纯本地离线解析,杜绝凭证外泄
解码操作全部在浏览器端通过原生 API 执行,Token 绝不会被发送到任何第三方服务器,可安全处理生产环境鉴权凭据。
过期状态直观预警与时钟换算
将 payload 中的 exp 与 nbf 字段即时换算为本地具体日期时间,明确提示剩余有效秒数或过期多久,大幅提高联调效率。
自动容错与 Base64Url 规范适配
自动识别并转换 URL 安全的 '-' 与 '_' 字符,自动补充缺失的 '=' 填充符,避免因格式微差导致常规解码失败。
JWT 核心安全概念与开发避坑要点
- •Base64Url 解码不等于安全验证:前端解码只是把明文还原展示,任何人都可以伪造或篡改未验证的 Token。涉及核心权限流转时,必须由后端使用私钥或密钥执行完整签名验签。
- •绝不在 Payload 中存放敏感密码与机密:Payload 仅仅进行了无密钥保护的 Base64 编码,任何拦截者都可以直接解码读取。切勿在 Token 中存放用户密码、银行卡号或私密密钥。
- •注意 exp 单位为整秒(10位):JWT 规范(RFC 7519)明确规定 exp(过期时间)和 iat(签发时间)使用 Unix 纪元秒。在前端对比 `Date.now()`(毫秒)时务必记得乘以 1000!
代码与转换对比示例
JWT 三段式结构解构示例
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTYiLCJuYW1lIjoiQWxpY2UiLCJyb2xlIjoiYWRtaW4iLCJleHAiOjE3NzQwMDAwMDB9.d7s8f9...{
"sub": "123456",
"name": "Alice",
"role": "admin",
"exp": 1774000000
}* Header 说明采用 HMAC-SHA256 算法,Payload 包含用户唯一标识 sub 与角色权限声明。
前端原生简易解码代码示例
function parseJwt(token) {
const base64Url = token.split('.')[1];
const base64 = base64Url.replace(/-/g, '+').replace(/_/g, '/');
return JSON.parse(decodeURIComponent(escape(atob(base64))));
}const payload = parseJwt(token);
console.log("User ID:", payload.sub);
console.log("Is Expired:", Date.now() >= payload.exp * 1000);* 前端解码仅能读取数据,绝不能替代服务端的签名真实性校验。
常见问题解答
Q: 为什么解码 JWT 不需要提供密码或私钥?
A: 因为 JWT 的前两部分(Header 和 Payload)仅仅是使用标准的 Base64Url 进行了编码以适配网络传输,并没有进行对称或非对称加密。只有校验第三部分(Signature 签名是否被篡改)时才需要密钥。
Q: JWT 常见的标准字段(Registered Claims)有哪些含义?
A: 常见包括:sub(主体,通常为用户 ID)、iss(签发者)、aud(受众目标服务)、exp(过期时间戳)、nbf(生效起始时间戳)、iat(签发时间戳)及 jti(Token 唯一识别码)。
Q: 我的 Token 粘贴进来显示无效或无法解析是怎么回事?
A: 请检查 Token 是否完整包含两个英文句点(.)分隔符。如果字符串被截断、末尾混入了空格或换行符,或者包含了非 Base64Url 字符,解码器将无法正确还原 JSON 结构。