JWT 过期检查器

检查 JWT 令牌过期时间并解码 JWT 负载

所有 JWT 解码和检查都在您的浏览器本地完成。您的令牌永远不会离开您的设备。

深度指南

读懂 JWT 的有效期:检查器解码什么、无法告诉你什么

检查器如何拆分并解码紧凑格式的 JWT,如何判断 exp、nbf 和 iat,绿色的“有效令牌”究竟意味着什么、不意味着什么,以及会被拒绝的输入形式;所有输出均来自真实页面。

最后核实: 资料来源: IETF — RFC 7519 本指南的纯文本版

关键数字一览

签名
从不验证
“有效令牌”只表示 exp 声明在未来。任何人都可以伪造一个通过此检查的令牌。
来源: IETF — RFC 7519
何时算过期
exp 早于设备时钟
恰好等于 exp 的那一秒页面仍显示有效;RFC 7519 规定“等于或晚于”exp 就必须拒绝。
接受的形式
由点分隔的三个部分,别无其他
开头的“Bearer ”、内部换行或 5 段式加密令牌都会报错。
显示的时间
UTC,日/月/年,24 小时制
例如 20/10/2026, 02:26:54 UTC,所有语言都一样。

排查可能由令牌过期引起的 401

检查器回答的是“这个令牌声称了什么?”,而不是“服务器会接受它吗?”。

  1. 步骤 1: 只复制令牌本身

    取三段式字符串,不要带 Authorization 头名称或 Bearer 前缀。把它当作凭证:持有有效令牌的人可以冒充该用户。

  2. 步骤 2: 查看状态和 exp 一行

    留意 exp 是否已过去、过去多久,以及 nbf 是否还在未来。不要把绿色勾当作其他任何事情的证明。

  3. 步骤 3: 与服务器时钟对照

    如果 exp 看起来没问题而服务器却不认,请转换 exp 和设备时间,查看是否存在时钟差异。

  4. 步骤 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 小时内过期。刷新令牌可以持续更长时间(几天到几周)。理想的过期时间取决于您的安全要求和用户体验需求。

资料来源

  1. IETF — RFC 7519, JSON Web Token (JWT) — exp, nbf, iat, NumericDate, unsecured JWTs, context-dependent validity.
  2. IETF — RFC 7515, JSON Web Signature (JWS) — The compact serialisation: base64url header, payload and signature.
  3. IETF — RFC 4648, Base64url encoding

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

把这个工具嵌入你的网站

免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。