JWT 的 exp 怎么换算成剩余时间
exp 减去当前 Unix 秒数,就是剩余秒数。exp 的单位是秒;十年内的值都是 10 位数字,看到 13 位说明签发方给的是毫秒。
- 公式:
exp - Math.floor(Date.now() / 1000) - exp 是秒级时间戳,13 位就是毫秒,除 1000 取整
- 时区不影响结果,本机时钟不准才会算错
- 「快过期」自己定,常见是剩 60 秒开始刷新
粘贴即自动处理,不用点按钮(Ctrl+Enter 立刻转换 / Esc 清空)
拖文件进来,或 ——截图直接 Ctrl+V 也行
任意类型 · 100 MB 封顶
粘贴、拖拽、Ctrl+V 截图都行
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 里没有这个字段,不代表永不过期,有效期怎么算由签发方定。
手算和写代码是同一件事
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,多绕一步,还容易把时区又算进去。
时区不用管,时钟得管
服务器在 UTC,你在东八区,算出来的剩余秒数一模一样。时间戳本身不带时区,差 8 小时只影响你怎么显示,不影响怎么比。
会把结果带偏的是本机时钟。手机或电脑慢了三分钟,倒计时就跟着错三分钟,token 明明还有效,前端却判成过期。之前排查过一个线上问题:同一批用户里只有一部分人反复被踢,最后定位到那批设备的 NTP 没同步。
校准办法很土但管用:读接口响应头里的 Date,跟本地时间对一下,差几十秒以上就别信本地计算了。
还有一种:本机时间没问题,服务端那边刚做过时间同步,签发时间和你的本地时间对不上。这类只能看服务端日志里的签发时间。
过期和快过期,标准自己定
服务端校验 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 工具能直接解开,省得自己处理 -_ 和缺失的填充。