JWT 过期检查器
检查 JWT 令牌过期时间并解码 JWT 负载
令牌状态
头部
负载
签名
Note: This tool only decodes JWT tokens. Signature verification requires the secret key and should be done on the server side.
所有 JWT 解码和检查都在您的浏览器本地完成。您的令牌永远不会离开您的设备。
深度指南
读懂 JWT 的有效期:检查器解码什么、无法告诉你什么
检查器如何拆分并解码紧凑格式的 JWT,如何判断 exp、nbf 和 iat,绿色的“有效令牌”究竟意味着什么、不意味着什么,以及会被拒绝的输入形式;所有输出均来自真实页面。
关键数字一览
- 何时算过期
- exp 早于设备时钟
- 恰好等于 exp 的那一秒页面仍显示有效;RFC 7519 规定“等于或晚于”exp 就必须拒绝。
- 接受的形式
- 由点分隔的三个部分,别无其他
- 开头的“Bearer ”、内部换行或 5 段式加密令牌都会报错。
- 显示的时间
- UTC,日/月/年,24 小时制
- 例如 20/10/2026, 02:26:54 UTC,所有语言都一样。
排查可能由令牌过期引起的 401
检查器回答的是“这个令牌声称了什么?”,而不是“服务器会接受它吗?”。
-
步骤 1: 只复制令牌本身
取三段式字符串,不要带 Authorization 头名称或 Bearer 前缀。把它当作凭证:持有有效令牌的人可以冒充该用户。
-
步骤 2: 查看状态和 exp 一行
留意 exp 是否已过去、过去多久,以及 nbf 是否还在未来。不要把绿色勾当作其他任何事情的证明。
-
步骤 4: 刷新或重新签发令牌
过期的令牌必须由身份提供方续期。签名、签发者和受众的验证仍在服务器上完成。
页面做了什么
紧凑格式的 JWT 由三个 base64url 字符串用点连接而成:头部、载荷、签名。页面先去掉粘贴文本的首尾空白,按 . 拆分,并要求恰好三个部分。它把前两个部分按 UTF-8 JSON 解码并重新缩进显示;第三部分不会被读取。不会向任何地方发送数据:页面脚本不发出任何网络请求。点击“解码 JWT”和点击“检查过期时间”做的事情完全相同,在输入框中按 Ctrl+Enter 也会运行。
JWT 载荷只是编码,并非加密。任何持有令牌的人都能读到每个声明,所以解码如此简单,也所以不应该把机密放进声明里。
如何判断 exp、nbf 和 iat
这些声明是 NumericDate 值:自 1970-01-01T00:00:00Z 起的秒数,不计闰秒(RFC 7519)。页面把它们与设备时钟比较。
| 声明 | 本页面的行为 | RFC 7519 的含义 |
|---|---|---|
exp |
已过去:红色“令牌已过期”及已过去的时长。在未来:绿色“有效令牌”及剩余时间 | 在此时间当时或之后,令牌不得被接受 |
nbf |
仅在仍在未来时显示(“令牌尚未生效”、“Valid in …”);已经过去的 nbf 不会提示 |
在此时间之前,令牌不得被接受 |
iat |
只显示,从不判断;未来的 iat 不会产生警告 |
令牌的签发时间 |
在服务器上未通过检查的令牌,在这里仍可能看上去很健康,因为服务器还会检查签名、签发者(iss)、受众(aud)以及自己的规则,而 RFC 7519 指出哪些声明是必需的取决于具体场景。
已核实的行为(用生成的令牌运行):
- 缺少
exp,或exp等于0,显示黄色“未设置过期时间”。零被当作不存在。 - 字符串形式的
exp(如"1792455807")会被接受并按数字比较。 - 以毫秒(13 位)给出的
exp会被当作秒读取:页面报告“有效令牌”,剩余约 2000 万天,年份为 58770。如果看到荒谬的过期时间,说明签发方用错了单位。 - 恰好等于 exp 的那一秒仍算有效,比 RFC 的规则晚一秒。
- 不使用任何宽限。RFC 7519 允许为时钟偏差留出一点余量;服务器常常这样做,本页面不会。
- 剩余时间显示天、小时和分钟,只有不足一天时才显示秒。
- 未加保护的令牌(
alg: none,签名为空,按 RFC 7519 第 6 节是合法的)同样显示为“有效令牌”。
示例
exp 在 2 小时 5 分钟之后的令牌(用 HS256 头部生成):剩余时间显示“2 小时 5 分钟 3 秒”,过期时间为 20/10/2026, 02:26:54 UTC,并显示签发时间。exp 在 2 天 1 小时 5 秒之前的令牌:“已过期: 2 天 1 小时 前”。nbf 在十分钟后、exp 在两小时后的令牌:同时显示“有效令牌”和“令牌尚未生效”,以及距生效的时间。
会失败的输入
| 粘贴的内容 | 信息 |
|---|---|
Bearer eyJ… |
解码 JWT 时出错(前缀使第一部分无效) |
| 两段,或五段(加密的 JWE) | JWT 必须由点分隔的 3 个部分组成 |
| 分成多行的令牌 | 解码 JWT 时出错(内部空白不会被去掉) |
| 不是 JSON 的载荷 | 解码 JWT 时出错 |
带填充字符 = |
解码 JWT 时出错(该格式使用不带填充的 base64url) |
载荷是 JSON 数组时可以正常解码,显示“未设置过期时间”并打印该数组。
提示: 用 Unix 时间戳转换器转换可疑的
exp。如果落在 1970 年,说明单位反了(秒被当成毫秒);如果落在遥远的未来,那就是毫秒。
常见错误
- 把“有效令牌”读成“真实的令牌”。只有持有密钥的服务器才能验证签名。
- 把线上的真实令牌粘贴到你无法控制的工具里。本页面在本地运行,但剪贴板或历史记录里的令牌仍然是凭证。
- 忘记载荷里的大数字会按 JavaScript 数字打印(
12345678901234567890变成12345678901234567000)。 - 拿设备时钟去比较另一时区的服务器,而忘了 exp 始终是 UTC。
相关工具
用 Unix 时间戳转换器转换 exp 和 iat,在 JSON 查看器中查看解码后的 JSON,或用 Base64 编码器手动解码单个片段。
常见问题
什么是 JWT 令牌?
JWT(JSON Web Token)是一种紧凑、URL 安全的令牌格式,用于在各方之间安全地传输信息。JWT 通常用于现代 Web 应用程序中的身份验证和授权。JWT 由三部分组成:头部、负载和签名,由点分隔。
我的 JWT 令牌会发送到服务器吗?
不会,所有 JWT 解码和过期检查完全在您的浏览器中进行。您的令牌永远不会离开您的设备,使此工具对生产和敏感身份验证令牌完全安全。
此工具验证 JWT 签名吗?
不,此工具仅解码 JWT 令牌以读取其内容并检查过期时间。它不验证加密签名。在生产应用程序中信任令牌内容之前,请始终在服务器上验证 JWT 签名。
"令牌已过期"是什么意思?
令牌已过期意味着 JWT 中的"exp"(过期)声明已超过当前时间。服务器不应接受过期的令牌,通常需要用户重新进行身份验证或刷新令牌。
如果我的 JWT 没有过期时间怎么办?
如果 JWT 不包含"exp"声明,从技术上讲它不会自动过期。但是,出于安全原因,通常不建议这样做。大多数身份验证系统应该在 JWT 上设置过期时间。
如何读取解码的 JWT 数据?
解码后,该工具会显示头部(包含算法和令牌类型)和负载(包含用户 ID、过期时间、签发时间和自定义数据等声明)。所有数据都以 JSON 格式显示,便于阅读。
为什么我的有效令牌显示为已过期?
检查您设备的系统时间。过期检查基于您的本地时钟。如果您的系统时间不正确,它可能会将有效令牌显示为已过期,反之亦然。还要验证令牌是否使用正确的过期时间签发。
我可以解码来自任何应用程序的令牌吗?
是的,此工具可以解码任何标准 JWT 令牌,无论是哪个应用程序或框架创建的。JWT 遵循标准化格式(RFC 7519),可跨所有平台和编程语言工作。
JWT 的三个部分是什么?
JWT 有三个由点分隔的 Base64URL 编码部分:头部(算法和类型)、负载(声明和数据)和签名(用于验证的加密签名)。格式为:xxxxx.yyyyy.zzzzz
使用此工具处理生产令牌安全吗?
是的,因为所有处理都在您的浏览器本地进行,令牌永远不会离开您的设备。但是,在粘贴敏感令牌时要小心。避免共享可能包含机密信息的解码令牌内容。
exp、iat 和 nbf 声明有什么区别?
exp(过期时间)是令牌过期的时间。iat(签发时间)是令牌创建的时间。nbf(生效时间)是令牌生效的时间。这三个都使用 Unix 时间戳(自 1970 年 1 月 1 日以来的秒数)。
JWT 令牌应该多久过期一次?
为了安全起见,访问令牌通常应在 15 分钟到 1 小时内过期。刷新令牌可以持续更长时间(几天到几周)。理想的过期时间取决于您的安全要求和用户体验需求。
资料来源
- IETF — RFC 7519, JSON Web Token (JWT) — exp, nbf, iat, NumericDate, unsecured JWTs, context-dependent validity.
- IETF — RFC 7515, JSON Web Signature (JWS) — The compact serialisation: base64url header, payload and signature.
- IETF — RFC 4648, Base64url encoding
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。
把这个工具嵌入你的网站
免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。