一个客服系统上线两个月,收到一条安全工单:员工离职后,管理员在后台点了「强制下线」,但那台电脑上的页面刷新一下还能继续用,直到第二天才失效。开发查了半天,说退出登录的接口已经调了,前端本地存储也清了。真正的原因是:登录态用的是 JWT,服务端不存任何东西,所谓「退出」只是浏览器删了本地那份 token,服务端根本不知道这个 token 应该作废。

这类问题在选型阶段就埋下了。JWT 的卖点是「服务端无状态」,而无状态的另一面就是「服务端没有能力撤销」。如果业务里有强制下线、改密踢人、封号立即生效,这个代价迟早要还。

这篇不讲三种方案的 API 细节,讲它们各自解决什么问题、在什么规模下会失效,以及一套能落地的组合方式。

先把三个词分开

很多选型争论,其实是把三件事混在一起说。

认证(Authentication)回答「你是谁」。密码、验证码、扫码、第三方登录,都是在确认身份。认证只发生在登录那一刻,之后靠会话凭证维持。
授权(Authorization)回答「你能做什么」。同一个登录用户,普通员工和管理员的权限不同。授权检查发生在每个请求上,和会话是两件事。
会话(Session)回答「这次访问怎么被记住」。登录成功后发一个凭证,后续请求带上它,服务端据此认出用户。凭证存在哪、怎么失效,就是选型的核心。

Session、JWT 都是「会话」的实现方式,OAuth2 则是「授权委托」的协议,它主要解决「让第三方应用在用户授权下访问资源」,并不直接等于登录。把 OAuth2 当登录方案用,是常见的第一类错误。

还有一层要单独想:单点登录。一个公司有十个系统,用户不想登录十次。这属于「多个系统共享认证结果」,可以用统一会话中心,也可以用 OAuth2 或 SAML 做身份提供方。它比单个系统的登录态复杂一个量级。

把这三件事分开之后,很多争论会自动消失。比如「JWT 能不能做权限控制」,答案是能携带权限快照,但快照会过期;「Session 能不能跨域」,答案是能,但要处理 Cookie 的域和 SameSite;「OAuth2 是不是登录协议」,答案是不是,登录要用它上面的身份层。先把问题归到认证、授权或会话,再谈具体技术,比直接比较三种方案的优缺点更有效。

Session:服务端记着,客户端只拿一个编号

Session 的做法很直白:登录成功后,服务端生成一个随机 ID,把用户信息、过期时间、权限快照存进服务端存储(内存、Redis、数据库都行),然后把 ID 放进 Cookie 发给浏览器。之后每个请求带上这个 Cookie,服务端拿 ID 去存储里查。

它的优点是可控。想踢人,删掉对应记录;想改权限,改记录;想统计在线设备,列出这个用户的所有会话。因为这些数据都在你手里,撤销是天然的。

代价是服务端有状态。单机内存存储,换一台机器登录态就丢了;多实例部署必须换成共享存储,比如 Redis。共享存储又带来新的问题:Redis 挂了,所有人都登不上去;跨地域部署时,会话查询会多一次跨区延迟。

# 会话键的常见结构
session:<random_id>  => {"user_id": 1024, "role": "admin", "expires_at": 1762560000}

# 查询与续期(Redis 命令示例)
GET session:8f3c2a...
EXPIRE session:8f3c2a... 1800

Cookie 的安全属性要一次配齐:HttpOnly 防脚本读取,Secure 只在 HTTPS 下发送,SameSite=Lax 或 Strict 降低跨站请求伪造风险。跨域前后端分离时,还要处理 SameSite=None; Secure 和 CORS 的 credentials 配置,这部分不配好,表现就是「登录接口成功,下一个请求却没带上 Cookie」。

Session 适合什么规模?单区域、实例数量可控、有 Redis 或类似共享存储、需要强撤销能力的业务。大多数内部系统和后台管理,选它不会错。

会话 ID 本身也要防攻击。登录成功后应该换一个新的会话 ID,不要沿用登录前的匿名会话,否则攻击者可以事先固定一个 ID,等用户登录后继续使用,这叫会话固定。会话 ID 要足够长、足够随机,不能是自增数字或用户 ID 的哈希;过期时间要分「闲置超时」和「绝对超时」两档,前者防止长期不操作还挂着,后者防止会话无限续命。用户改密码、切换角色、触发高风险操作时,最好重新生成会话。

JWT:把信息写在凭证里,服务端不查

JWT 是 JSON Web Token 的缩写,结构分三段:头部、载荷、签名,中间用点连接。载荷里可以直接放用户 ID、角色、过期时间。服务端收到后验签名,签名对就认为内容没被改过,不需要查存储。

所以它天生适合「服务多、跨域、无状态」的场景:网关验一次签名,后面每个服务都能自己验,不用每个服务都连会话库。移动端、第三方调用方也更喜欢把凭证放在请求头里,而不是依赖 Cookie。

但「不查存储」意味着两件事做不到:即时撤销,以及权限实时变更。用户改了密码,旧 token 在过期前依然有效;管理员撤了某个角色,token 里的角色快照还是旧的。要解决,就得额外引入黑名单或版本号,一引入,无状态的优势就打折了。

Session 的账

撤销即时、权限可实时改、客户端实现简单;代价是服务端要存、要多一次查询、共享存储成为关键依赖。适合单区域、需要强控制的系统。

JWT 的账

服务端无状态、跨服务验签方便、适合移动端和第三方;代价是撤销要额外设计、token 一旦泄露在有效期内都能用、载荷不能放敏感信息。适合短有效期加刷新机制的场景。

如果选 JWT,有两条底线。第一,有效期要短,访问 token 十五分钟到一小时,长会话用刷新 token 换新;第二,不要放 localStorage。localStorage 能被任何一段注入的脚本读走,一旦 XSS,token 直接泄露。更稳的做法是放进 HttpOnly Cookie,或者移动端放进系统安全存储。

刷新 token 也要设计清楚:它应该是一次性的,用过就换新的;服务端要能识别重放,旧刷新 token 再次出现时,把整个会话族作废。否则攻击者偷到刷新 token,就能长期续命。

还要记住 JWT 的载荷只是编码,不是加密。任何人拿到 token 都能解开看内容,所以不要放手机号、身份证号、内部权限细节。签名保证的是「内容没被改」,不是「内容看不见」。需要加密的场景要用 JWE 或干脆不放敏感信息。另外,验签时要固定算法,不要接受 token 头部声明的任意算法,否则会出现「改成 none 算法绕过签名」这类经典漏洞。

把 JWT 的有效期设成七天甚至三十天,是最常见也最危险的偷懒。token 一旦泄露,你没有任何手段让它提前失效。短有效期带来的刷新复杂度,是必须付的成本,不是可以绕过的麻烦。

OAuth2:它解决的是「授权委托」

OAuth2 要解决的问题是:用户想让 A 应用访问自己在 B 平台的数据,但不想把 B 平台的密码交给 A。于是 B 平台发一个有限权限、有限时间的 access token 给 A,A 拿它去调接口。这里的核心是「委托」和「范围」,不是「登录」。

最常见的授权码模式流程:A 应用把用户跳到 B 的授权页;用户同意后,B 带着一个一次性 code 跳回来;A 在服务端用 code 换 access token;之后 A 用 token 调 B 的接口。服务端换 token 这一步很关键,避免 token 出现在浏览器地址栏。

OAuth2 里有四个角色,分清楚才知道谁该做什么。资源所有者是用户;客户端是想访问数据的应用;授权服务器负责发 token;资源服务器存放数据、校验 token。一个常见的错误是把授权服务器和资源服务器混成一个,token 的签发和校验都在业务服务里做,结果每个业务服务都要维护一套密钥和 scope 逻辑,越扩越乱。

移动端和单页应用还要加 PKCE。PKCE 的做法是客户端先生成一个随机串,把它的哈希发给授权服务器,换 token 时再出示原串。这样即使 code 被截获,没有原串也换不到 token。

GET /authorize?response_type=code
  &client_id=web-app
  &redirect_uri=https://app.example.com/callback
  &scope=orders:read profile
  &state=random-csrf-token
  &code_challenge=BASE64URL(SHA256(verifier))
  &code_challenge_method=S256

如果只是「用微信或 GitHub 登录」,通常走的是 OpenID Connect,它在 OAuth2 之上加了一层身份信息(id_token)。这时 access token 用来调用户信息接口,id_token 用来确认身份。两者不要混着用,更不要把 access token 直接当登录态发给前端长期保存。

scope 要按最小权限申请。只读订单就不要带写入 scope,只查公开资料就不要带手机号。scope 写得越宽,token 泄露后的损失越大,用户看到授权页上的权限列表也越容易放弃登录。scope 的命名要和资源对应,比如 orders:read、orders:write,不要用一个笼统的 all 图省事。授权服务器还应该支持用户撤销某个应用的授权,撤销后对应的 refresh token 立即失效。

OAuth2 的代价是链路长、参与方多、配置项多。自建授权服务器、管理 client、处理回调域名、scope 设计、token 轮换,每一项都能出问题。只有当你确实需要「第三方应用代表用户访问资源」时才值得上;单个自家前端登录,用 Session 或 JWT 就够了。

几种典型故障,先查哪里

现象真实原因第一步查什么
点了退出,旧凭证还能用JWT 无状态,服务端没有撤销机制看登出接口是否只清了客户端存储,服务端有没有黑名单或会话删除
改密码后,其他设备仍然在线会话没有绑定密码版本,旧 token 继续有效查用户表是否有 token_version 字段,并在验签时比对
多实例部署后登录时有时无Session 存在单机内存,请求落到别的实例查不到看会话存储是本地内存还是 Redis,负载均衡是否开启会话保持
登录接口成功,下一个请求 401跨域请求没带 Cookie,或 Cookie 的 SameSite 配置不对看浏览器开发者工具里请求头有没有 Cookie,响应是否带 Set-Cookie
刷新 token 后陷入死循环刷新接口本身也要求有效 access token,过期后互相等待看刷新接口的鉴权中间件是否排除了自身
第三方登录回调报 state 不匹配state 没存或跨域后丢失,CSRF 防护失效查回调时的 state 与发起授权时写入的是否为同一个
权限改了但接口仍放行权限快照写进了 JWT,过期前不会更新看鉴权时读的是 token 里的角色还是实时权限服务

这张表里最值得记住的是前两条:它们不是配置问题,而是选型时就应该想清楚的边界。如果业务明确需要即时踢人,选 JWT 就必须同时设计撤销方案,否则「退出登录」只是一个前端动画。

还有一种「偶发 401」值得单独说。JWT 里通常有过期时间,签发机和验证机的时钟如果差几分钟,就会出现刚签发就过期,或者过期后还能用一会儿。容器环境里时钟同步不一定完美,验签时最好允许几十秒的误差,并监控时钟偏差。排查这类问题时,先对比两边的 UTC 时间,比一行行看鉴权代码快得多。

一套可落地的组合

多数中小系统,我建议这样组合:浏览器端用 Session,会话存 Redis;移动端或开放 API 用短期 JWT 加刷新 token;需要第三方接入时再加 OAuth2 授权服务器。不要一开始就上全套,按调用方类型分层。

目录上把认证和授权分开,避免所有逻辑堆在一个中间件里。

src/
  auth/
    login.js          校验账号密码,创建会话
    session-store.js  Redis 读写与过期
    jwt.js            签发、验签、密钥轮换
    authorize.js      角色与资源权限检查
  routes/
    auth.route.js     /login /logout /refresh
    orders.route.js   requireAuth + requireRole("admin")

会话 ID 和 JWT 签名密钥都要能轮换。会话 ID 用足够随机的值,别用自增用户 ID;JWT 密钥至少准备两个,签发用新的,验签同时接受旧的,等旧 token 全部过期再删旧密钥。密钥写死在代码里、跟着仓库走,是另一个常见问题。

密码存储不要自己发明算法。用成熟的 bcrypt、scrypt 或 Argon2,并设置合理的成本参数;不要用 MD5、SHA1,也不要直接存明文或用固定盐。登录失败要统一返回「账号或密码不正确」,不要区分「用户不存在」和「密码错误」,否则等于给攻击者一个枚举账号的接口。连续失败要有限速和锁定策略,但锁定时间别太长,避免被恶意触发导致正常用户进不来。

// 验签时的密钥轮换思路(伪代码)
const keys = loadKeysFromEnv();       // 当前密钥 + 上一把
const decoded = verify(token, keys);  // 任意一把验过即可
if (decoded.kid === keys.previous.id) {
  // 可选:在响应里提示客户端换新 token
}

验证方法:登录后拿 Cookie 或 token 调一个受保护接口,应当 200;手动改掉 token 最后一个字符,应当 401;在 Redis 删除会话键,应当立即 401;改用户密码后旧 token 应当 401。四条都过,撤销链路才算通了。

换语言时,这一层要改的是「会话存储客户端和签名库」,流程不变。Node 用 jsonwebtoken 或内置 crypto,Java 用 Spring Security,Go 用标准库加中间件,Python 用 Flask-Login 或 PyJWT。选型结论不会因为语言变。

边界与代价

Session 的边界在规模和区域。单区域、实例数几十以内,Redis 扛得住。跨洲部署、每个请求都要查一次会话,延迟会变成可见成本;这时要么做区域化会话,要么改用短期 JWT 减少查询。

JWT 的边界在撤销需求。只要业务出现「立即封号」「强制下线」「权限实时生效」,就必须额外维护黑名单或版本号,无状态优势会缩小。黑名单本身又是有状态的,规模大了还要考虑存储和查询成本。

OAuth2 的边界在参与方数量。只有一个自家前端时,它是明显的过度设计;有三五个外部应用要接,它才划算。自建授权服务器还要考虑合规、审计、密钥托管,这些成本经常被低估。

安全没有「配一次就完事」。Cookie 属性、CORS、CSRF、token 存储位置、日志脱敏,每一项都要在真实浏览器里验证。只在 Postman 里调通,不代表浏览器端能用。

登录和权限变更要留审计。谁在什么时候登录、从哪个 IP、失败了几次、管理员什么时候改了谁的权限,这些记录在出事时比业务日志更有用。审计日志要单独存储、限制访问权限,并防止被普通运维随手删除。它不解决登录本身的问题,但能回答「这件事是谁做的」。

判断选型是否过头,有一个简单问题:如果现在只有一个 Web 前端、没有第三方、没有移动端,你需要几套机制?答案通常是一套 Session。等第二个调用方真的出现,再扩展,比提前搭好三层认证体系更省事。

当天可以自验的五件事

  1. 登录你的系统,复制凭证,点退出后再用同一凭证调一次受保护接口,看是否真的 401。
  2. 在浏览器开发者工具里检查会话 Cookie 是否有 HttpOnly、Secure、SameSite 三个属性。
  3. 改一次密码,确认其他设备上的旧会话是否失效;没失效就说明缺 token 版本或会话清理。
  4. 把 JWT 的第三段(签名)改一个字符,确认接口返回 401 而不是 500。
  5. 画出你系统里认证、授权、会话三条链路,标出哪一步依赖外部存储;那个存储挂掉时,系统会退化成什么样。

下一篇讲限流、重试与熔断。鉴权解决「谁能进来」,但进来的人太多时,系统仍然会被打穿。重试还会把一次小故障放大成雪崩,这部分需要单独的防线。