JWT 的 exp 怎么换算成剩余时间

exp 减去当前 Unix 秒数,就是剩余秒数。exp 的单位是秒;十年内的值都是 10 位数字,看到 13 位说明签发方给的是毫秒。

  • 公式:exp - Math.floor(Date.now() / 1000)
  • exp 是秒级时间戳,13 位就是毫秒,除 1000 取整
  • 时区不影响结果,本机时钟不准才会算错
  • 「快过期」自己定,常见是剩 60 秒开始刷新
b64file — converter · local

粘贴即自动处理,不用点按钮(Ctrl+Enter 立刻转换 / Esc 清空)

粘贴、拖拽、Ctrl+V 截图都行

[01]

exp 就是一个 Unix 秒数

RFC 7519 里 exp 的类型叫 NumericDate:从 1970-01-01T00:00:00Z 起算的秒数,不跳闰秒。它没有格式,就是一串整数,塞在 payload 的 JSON 里。

看一眼位数能判断单位。2026 年的秒级时间戳是 10 位,2038 年之后变成 11 位;13 位是毫秒。JavaScript 的 Date.now()、Java 的 System.currentTimeMillis() 默认都给毫秒,直接拿去跟 exp 比,差一千倍。

exp 在规范里是可选声明。token 里没有这个字段,不代表永不过期,有效期怎么算由签发方定。

[02]

手算和写代码是同一件事

const exp = 1767225600;                    // payload 里的 exp
const now = Math.floor(Date.now() / 1000); // 当前秒数
const left = exp - now;                    // 剩余秒数,负数即已过期
const when = new Date(exp * 1000);         // 换成可读时间

* 1000 只在构造 Date 那一步用,别把乘过的值拿回去做比较。想显示成北京时间,交给 toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' })。

同族的还有 iat(签发时间)和 nbf(生效时间),单位一样是秒。想看 payload 里还写了什么,用 JWT 解码 拆开。

要显示成「还剩 12 分钟」这种,把剩余秒数除 60 取整就行。别拿两个 Date 相减再除 1000,多绕一步,还容易把时区又算进去。

[03]

时区不用管,时钟得管

服务器在 UTC,你在东八区,算出来的剩余秒数一模一样。时间戳本身不带时区,差 8 小时只影响你怎么显示,不影响怎么比。

会把结果带偏的是本机时钟。手机或电脑慢了三分钟,倒计时就跟着错三分钟,token 明明还有效,前端却判成过期。之前排查过一个线上问题:同一批用户里只有一部分人反复被踢,最后定位到那批设备的 NTP 没同步。

校准办法很土但管用:读接口响应头里的 Date,跟本地时间对一下,差几十秒以上就别信本地计算了。

还有一种:本机时间没问题,服务端那边刚做过时间同步,签发时间和你的本地时间对不上。这类只能看服务端日志里的签发时间。

[04]

过期和快过期,标准自己定

服务端校验 exp 一般留一点容差,应付网络延迟和时钟漂移。Node 的 jsonwebtoken 有个 clockTolerance 选项,单位是秒;其它语言的库大多也有类似参数。你在前端卡着 exp 那一秒判断,可能比服务端早一步。

「快过期」没有统一答案。常见做法是剩余不到 60 秒就静默刷新,用户点按钮之前先换好。刷新接口要防并发——页面同时发五个请求,别刷五次 token,加个标记位排队。

前端算出来的过期只影响体验。鉴权必须在服务端做,payload 是明文,谁都能改 exp,签名才防篡改。

刷新失败要能退回登录页,别让用户卡在一个转圈的界面上。401 到手先看响应体,有些服务端把「已过期」和「签名不对」分开返回,处理方式不一样。

常见问题

exp 是秒还是毫秒?

秒。RFC 7519 的 NumericDate 定义就是秒。拿到 13 位数字,说明签发方给了毫秒,除以 1000 向下取整再用。

token 里没有 exp,是不是永不过期?

规范里 exp 可选,缺省表示这个字段不参与过期判断。实际会不会过期由签发方决定,看它有没有别的机制。

本地时间和服务器差几分钟,影响大吗?

差多少就错多少。差三分钟,倒计时就少三分钟,可能提前踢人,也可能放过已经过期的 token。先用响应头的 Date 对齐。

payload 那一段要自己解吗?

不用。payload 是 base64url,Base64URL 工具能直接解开,省得自己处理 -_ 和缺失的填充。

相关工具与指南