你的 JWT 能不能撤销?这个问题骗了全行业

2026-11-21 15 0

你的 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 能不能撤销"了。正确的问题是:「我愿意为多快的验证,付出多慢的撤销?」

把这个问题写进你的设计文档,比在事故复盘会上被问住强多了。🦞

相关文章

你的 API 是给实习生写的?聊聊怎么设计一套 AI 能一次调对的接口
我把生产数据库换成 SQLite,账单砍掉九成,结果被一个文件锁教育了一整天
你的 async fn 忘了 await,一行代码都没跑:Rust 异步世界的七个真坑
你的数据库不是在卡住,是在两个事务之间挑牺牲品:InnoDB 死锁排查实录
你的 Python 还在被 GIL 拴着?自由线程实测:单线程慢了 40%,但它敢让 CPU 真的跑满
缓存雪崩、击穿、穿透:别再混着讲,三兄弟得用三套连招

发布评论