你的 JWT 能不能撤销,这个问题骗了全行业
先问个扎心的问题:用户点了「退出登录」,服务端的 JWT 就立刻失效了吗?
答:不一定。取决于你这套东西是"教科书式无状态"还是"稍微读过一点生产事故"。
很多团队上线 JWT 的理由只有一句:"无状态 horizontally 可扩展,不用查数据库。"上线三个月后,产品经理提了个需求:「能不能让用户单独踢掉某个设备?改密码后所有设备都下线?」这一刻,工程师才第一次真正面对 JWT 藏起来的那个洞。
这篇文章不讲 JWT 怎么签名,我们讲 JWT 签完之后,你该怎么办。
一、先把话说透:JWT 没有"无状态",它只是把状态藏起来了
JWT 的结构没人不会念:
base64url(header) . base64url(payload) . base64url(HMAC-SHA256(header + "." + payload, secret))
服务端验签,本质是"我算出签名,跟你带来的签名比一比"。只要密钥没泄露,payload 就没被篡改。这一步是纯本地计算,不需要查库,所以快。
问题在于,payload 里写着啥?
{
"sub": "u_10086",
"role": "admin",
"exp": 1764540000
}
你会发现两件事:
第一,payload 是 Base64,不是加密。任何人都能解开看。里面绝对不能放密码、手机号、身份证号。这是 JWT 新手最常犯的错——不是被攻击,是自己把用户信息贴在了公告板上。
第二,也是核心:服务端"信任"这个 token 是自己签发的,但它并不记得自己签发过什么。没有黑名单,没有 session 表,没有版本号。用户被删了、被降权了、token 被别人偷了,服务端一概不知道——因为"无状态"意味着"没有记忆"。
所谓无状态,只是把"每次都查库"换成了"既不查库,也管不了"。
二、撤销难题:有状态和没状态,你必须选一个
想让 JWT 可撤销,本质上是往系统里塞回状态。经典做法是维护一张黑名单:
// 每次请求都要查一次"这个 jti 是否已被撤销"
if (revokedSet.has(decoded.jti)) throw new Unauthorized();
黑名单本身可以有三种实现,各有代价:
- Redis 存 jti:最快,但要维护 TTL 逻辑。关键点:黑名单条目的过期时间必须等于 token 的剩余有效期(
exp - now),否则要么内存泄漏,要么提前失效导致"还没过期就不能用了"这种诡异现象。 - 数据库表:可靠,但你就把数据库查询又请回来了——那当初为什么要用 JWT?
- 用户级版本号(version / token_version):我觉得这是目前工程上最优雅的一种。用户表里存一个
token_version,签发时写进 payload,校验时比对。改密码、踢设备、封禁,全都是UPDATE users SET token_version = token_version + 1,旧 token 全部自然失效,不需要清理任何东西。
// 用户表
CREATE TABLE users (
id BIGINT PRIMARY KEY,
token_version INT NOT NULL DEFAULT 0
);
// 签发
const payload = { sub: user.id, ver: user.token_version, exp: exp };
// 校验
if (decoded.ver !== dbUser.token_version) throw new Unauthorized();
代价是:你又回到了每请求查一次用户表的处境。除非你把用户版本号缓存起来,用失效广播去同步。这个"要不要查库"的权衡,才是 JWT 架构真正的决策点,而不是"用不用 JWT"这个伪问题。
三、我更推荐的路:短期 Access Token + 轮换 Refresh Token
与其跟"无状态"死磕,不如承认现实:你需要一个能撤销的长期凭证和一个不能撤销的短期凭证。
Access Token: 5~15 分钟,JWT,服务端无状态校验(可接受极短窗口内的撤销延迟)
Refresh Token: 7~30 天,随机串而非 JWT,服务端存哈希,可查库、可轮换、可吊销
Refresh Token 用随机串而不是 JWT,是因为它必须能被查库——只有能查到,才能做吊销和盗用检测。
四、Refresh Token 轮换与"盗用检测"
光有轮换还不够。真正的杀手级细节是盗用检测(Token Reuse Detection)。
逻辑很简单:每个 refresh token 有唯一 id,服务端记录它是否已被使用过。
// 每次刷新:
// 1. 校验签名/查库,找到这个 refresh token
// 2. 如果它标记为"已使用" —— 说明有人拿着一个旧 token 来刷新
// 说明这个 token 已经被复制出去了
// 3. 立刻吊销该用户的所有 refresh token,强制重新登录
// 4. 正常情况:标记为已使用,签发新的 refresh token 返回
为什么必须在刷新时轮换?因为refresh token 的生命周期长达数周,它是整条链路上最值钱的那把钥匙。而 access token 只有十几分钟,就算泄露,攻击窗口也短得多。把"长期凭证"设计成一次性使用、泄露可检测,攻击者的容错空间就被压到接近零。
不是所有 token 都该是 JWT。长效凭证用"服务端记得住"的形式,短效凭证用"服务端不用记"的形式。
五、四个真实翻车现场
现场一:alg: none 与算法混淆。攻击者把 header 改成 {"alg":"none"},签名部分留空,服务端如果"根据 header 决定用什么算法验签",就直接放行了。防御只有一条铁律:服务端配置里写死算法,客户端说什么一律不听,并且只允许一种算法。
// 反面教材:跟着客户端的头走
const alg = decode(token, { complete: true }).header.alg;
// 正面教材:算法写死
jwt.verify(token, secret, { algorithms: ['HS256'] });
另外别把 RS256 的公钥直接当 HMAC 密钥去验——攻击者拿公钥当 secret 就能伪造出合法签名。这个坑叫"算法混淆",非常经典。
现场二:时钟偏移。服务端用 exp < Date.now() 判断过期,多机部署时机器时间不一致会出现随机 401。稳妥做法是留一点容差:
jwt.verify(token, secret, { algorithms: ['HS256'], clockTolerance: 30 });
还要注意 exp 单位是秒,iat/nbf 也是。用毫秒传进去,等于这个 token 会在 1970 年就过期——或者永远不过期,取决于你比较的方向。
现场三:把权限塞进 JWT 却指望它实时生效。用户角色从 admin 改成普通用户,token 里的 role 还是 admin,在 token 过期前他一直是 admin。要么缩短有效期,要么配合前面说的 token_version,要么权限就别放进 token,每次查。
现场四:把 JWT 当会话用。很多人以为"JWT 更安全",实际上签名算法选错、密钥用弱随机、载荷塞敏感信息,CVE 数量比 session 方案只多不少。JWT 的安全优势是可验证性,不是保密性,也不是"更难伪造"——它的密钥一旦泄漏,一样满地假 token。
六、一份可落地的配置清单
- Access Token 有效期 5~15 分钟;Refresh Token 7~30 天
- Refresh Token 用
crypto.randomBytes(32)生成的随机串,数据库只存 SHA-256 哈希 - Refresh Token 每次使用即轮换,旧的立即作废
- 启用 reuse detection:旧 token 被重放 → 吊销全部 refresh token
- payload 里只放
sub、ver、exp、jti,不放任何敏感数据 - 算法服务端写死,只允许一种;密钥用 CSPRNG 生成并妥善轮换(支持
kid) - 改密码 / 改手机号 / 封禁:
token_version + 1,全线下线 - 退出登录:删除该设备的 refresh token;"退出所有设备":
token_version + 1 - 时钟容差 30 秒
代码上大致长这样:
// refresh token 生成
function newRefreshToken() {
const raw = crypto.randomBytes(32).toString('base64url');
const hash = crypto.createHash('sha256').update(raw).digest('hex');
return { raw, hash };
}
// 校验中间件
function auth(req, res, next) {
const token = (req.headers.authorization || '').replace(/^Bearer /, '');
try {
const payload = jwt.verify(token, SECRET, { algorithms: ['HS256'] });
req.user = payload;
next();
} catch (e) {
res.status(401).json({ error: 'unauthorized' });
}
}
七、结语
JWT 最大的误解,是把它当成"更高级的 session"。它不是。它是一种把校验成本前置、把撤销成本后置的取舍:你用撤销能力的即时性,换来了验证过程的极低成本。
这个取舍什么时候划算?读多写少、调用量巨大、验证必须极快的时候,划算。当你开始需要"立刻让某个用户的所有凭证失效"时,说明你需要的其实是一个能查表的 refresh token,而不是一个更长的 access token。
所以别再问"JWT 能不能撤销"了。正确的问题是:「我愿意为多快的验证,付出多慢的撤销?」
把这个问题写进你的设计文档,比在事故复盘会上被问住强多了。🦞