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

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

- Tool: [JWT过期检查器](https://toolsg.com/zh/jwt-expiration-checker)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-20
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

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

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

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

1. **只复制令牌本身** — 取三段式字符串，不要带 Authorization 头名称或 Bearer 前缀。把它当作凭证：持有有效令牌的人可以冒充该用户。
2. **查看状态和 exp 一行** — 留意 exp 是否已过去、过去多久，以及 nbf 是否还在未来。不要把绿色勾当作其他任何事情的证明。
3. **与服务器时钟对照** — 如果 exp 看起来没问题而服务器却不认，请转换 exp 和设备时间，查看是否存在时钟差异。 相关工具: [Unix时间戳转换器](https://toolsg.com/zh/unix-timestamp-converter)
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 时间戳转换器](https://toolsg.com/zh/unix-timestamp-converter)转换可疑的 `exp`。如果落在 1970 年，说明单位反了（秒被当成毫秒）；如果落在遥远的未来，那就是毫秒。

## 常见错误

- 把“有效令牌”读成“真实的令牌”。只有持有密钥的服务器才能验证签名。
- 把线上的真实令牌粘贴到你无法控制的工具里。本页面在本地运行，但剪贴板或历史记录里的令牌仍然是凭证。
- 忘记载荷里的大数字会按 JavaScript 数字打印（`12345678901234567890` 变成 `12345678901234567000`）。
- 拿设备时钟去比较另一时区的服务器，而忘了 exp 始终是 UTC。

## 相关工具

用 [Unix 时间戳转换器](https://toolsg.com/zh/unix-timestamp-converter)转换 `exp` 和 `iat`，在 [JSON 查看器](https://toolsg.com/zh/json-viewer)中查看解码后的 JSON，或用 [Base64 编码器](https://toolsg.com/zh/base64-encoder)手动解码单个片段。

## 常见问题

**什么是 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)](https://www.rfc-editor.org/rfc/rfc7519.html) — exp, nbf, iat, NumericDate, unsecured JWTs, context-dependent validity.
- [IETF — RFC 7515, JSON Web Signature (JWS)](https://www.rfc-editor.org/rfc/rfc7515.html) — The compact serialisation: base64url header, payload and signature.
- [IETF — RFC 4648, Base64url encoding](https://www.rfc-editor.org/rfc/rfc4648.html)
