业务高峰一到,你把应用从 1 台扩到 4 台,用户却每隔几分钟被强制下线。原因:会话存在单机内存里,负载均衡把请求打到没有登录记录的那台。解法就是把会话搬进 Redis——Sa-Token 对此的支持是"换依赖即上集群"。
前置阅读:18.3 用过单机会话。这篇看 Redis 存储与集群部署下会话怎么共享。
上面这个场景每个做微服务的人都踩过。更狠的是:业务缓存和会话共用一个 Redis,大促时业务缓存把内存打满,触发逐 key 淘汰——登录态被随机淘汰掉,用户集体掉线。这就引出两条主线:会话集中存储、存储物理隔离。
单机内存会话像每个店员兜里揣一把钥匙——客人换了店员就开不了柜。Redis 会话像前台统一的寄存处,谁当班都能凭票取件。
而独立 Redis(Alone-Redis)就像贵重物品单独锁一个保险柜:普通寄存再挤,也挤不掉贵重柜。登录态就是贵重物品,不该和业务缓存放一个柜子。
<!-- 换掉默认内存存储,接入 Redis -->
<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-redis-jackson</artifactId>
<version>1.44.0</version>
</dependency>
# 集群形态(官方 demo:sa-token-demo-alone-redis-cluster)
alone-redis:
pattern: cluster
cluster:
nodes: {{REDIS_NODE_1}}:3000,{{REDIS_NODE_1}}:3001,{{REDIS_NODE_1}}:3002
max-redirects: 2
# 哨兵形态见同目录 application_sentinel.yml
// 二级认证:敏感操作前要求再验一次
StpUtil.openSafe(120); // 输入密码后开启,有效期 120 秒
if (!StpUtil.isSafe()) { // 敏感接口检查
return "请先完成二次校验";
}
doSensitiveThing();
// 踢人下线
StpUtil.kickout(10001); // 踢指定账号(对方收到被踢通知)
StpUtil.logout(10001); // 注销(无通知)
一切的基础是 SaTokenDao(SaTokenDao.java:33)这个持久化契约:string、object、session 三套读写加 searchData 和生命周期方法。八个实现覆盖所有主流存储:
SaTokenDaoDefaultImpl(单机, ConcurrentHashMap)SaTokenDaoForRedisTemplate / ForRedisson / ForRedisxForCaffeine / ForHutoolTimedCacheForRedisTemplateUseJdkSerializer框架代码不 import 任何 Redis 类,注入靠 SaManager.setSaTokenDao()。这是工厂加 SPI 式注入:core 定义契约,插件提供实现,Spring Boot starter 里用条件装配自动注入 Redis 版 Dao。所以"上集群"的动作就是加一个依赖。
接入 Redis 后的会话布局:token 映射、Account-Session、Token-Session、权限缓存全部进 Redis。应用节点自身完全无状态,可以任意加减副本——这就是它集群模式的全部真相:无状态应用加集中式会话。Redis 端单机、主从、哨兵、Cluster 全形态支持,demo 目录里有现成配置。
独立 Redis 插件(sa-token-alone-redis,注入类 SaAloneRedisInject)更进一步:给鉴权数据配一个专用 Redis 实例,与业务 Redis 物理隔离。生产最佳实践是"鉴权 Redis 与业务缓存分库甚至分实例",避免业务侧缓存风暴拖垮登录。
二级认证(SaSafeMode):openSafe(timeout) 在当前会话上打一个"已通过敏感校验"的标记并限时,isSafe() 检查。改密码、删数据这类操作前套一层,防止 token 被偷后直接执行高危动作。@SaCheckSafe 注解可声明式开启。
踢人下线 vs 注销下线:kickout 和 logout 都删会话,区别在事件与体验——kickout 广播"被踢"事件,客户端能收到通知跳转提示页;logout 是安静退出。配合观察者模式(Observer,状态变化时广播给所有订阅者):SaTokenEventCenter 加 SaTokenListener,登录、注销、踢下线、封禁、续期等十三类事件全部广播,踢人时推 WebSocket 通知就是标准用法。
自动续签是策略 SaStrategy.autoRenew:每次请求校验通过后,如果剩余有效期低于阈值就顺延。默认实现依赖 Redis 里的活跃时间字段——换成 Stateless JWT 模式后这条策略自然失效,因为无状态模式根本没有存储可写。
再细看 Redis 里的会话数据结构,这是排查问题的地图。token 首先是几个键值对:token → loginId 的映射键、loginId → token 列表 的反向映射键,两者配合才能既"凭 token 查人"又"凭人踢 token"。Account-Session 是一个 Hash 结构,里面挂着 Sign-in 记录:每个 token 的登录时间、设备、活跃时间。踢人就是从 Session 里摘掉对应记录,再删掉正向映射。
活跃时间字段是自动续签的依据。默认策略是"临期续签":剩余有效期低于配置阈值时才刷新,避免每个请求都写 Redis。大流量下这个细节很关键——如果每次请求都 set 一次过期时间,Redis 写压力会随流量线性上涨。
分布式部署下的会话一致性还有一层容易忽略:多账号体系、多节点部署时,SaManager 的组件配置必须各节点一致。因为某些校验依赖内存态的配置对象,节点 A 开了自动续签、节点 B 没开,用户就会体验"有时续期有时掉线"的灵异现象。
集群形态的选择也给个实操结论:会话量中小规模用主从加哨兵,足够稳且运维简单;会话量大到需要 Cluster 时,注意 token 键没有 hash tag,会散到不同槽上,单个用户的多次请求可能打到不同节点——对会话场景这没有正确性问题,因为每条命令独立完整,但不要指望用事务把一个用户的多个键一起改。
最后提一下参数签名插件(sa-token-sign):跨系统 API 调用时对参数做防篡改和防重放校验,通常是开放平台或支付回调的硬需求。它和 Same-Token 互补——Same-Token 管"请求来自可信调用方",sign 管"请求内容没被改过、不是重放"。
SaManager 里的组件若被运行时代码 set 过,各节点要保持一致,否则行为漂移「Sa-Token 怎么支持集群?」——答:SaTokenDao 抽象持久化,接入 Redis 插件后所有 token 和 Session 集中存储,应用无状态可水平扩容;Redis 支持 Cluster 和哨兵形态。
「踢人下线和注销的区别?」——答:都删会话数据,kickout 额外广播被踢事件,客户端可感知并提示;logout 静默退出。事件监听靠 SaTokenListener 观察者机制。
「为什么鉴权 Redis 要和业务 Redis 隔离?」——答:业务缓存把 Redis 打满或触发淘汰时,登录态会被连坐。Alone-Redis 插件让鉴权走独立实例,故障域互不影响。