身份认证与应用安全 / 系统课时

配置同端互斥登录规则

配置同端互斥登录规则

同端互斥解决的是“同一账号允许手机和电脑同时在线,但同类终端只能保留一个登录”的问题。关键不是简单禁止并发,而是把并发限制和设备类型组合起来,让新登录只替换同类型的旧会话。

学习目标

  • 配置同一账号的非并发登录规则
  • 理解设备类型如何限定“顶人”范围
  • 能判断旧登录被替换后应出现的状态

先确定互斥边界

Sa-Token 的 isConcurrent 决定同一账号是否允许并发登录。要实现同端互斥,需要把它设为 false,并且登录时始终传入稳定的设备类型,例如 PC、APP。这样框架才能把“同一个账号的两个 PC 登录”识别为冲突,而把 PC 与 APP 视为不同端。

yaml
sa-token:
  is-concurrent: false

生效行为:同一账号再次以相同设备类型登录时会触发替换;不同设备类型可以分别保持登录状态。当前版本默认的替换范围是当前设备类型;如果项目曾把 replacedRange 改成全部设备类型,应先恢复为当前设备类型范围,否则会变成跨端互斥。

登录时必须声明设备类型

仅配置 is-concurrent: false 还不够。如果登录时不传设备类型,多个终端都会落到默认设备类型中,浏览器和移动端也会互相挤掉。

片段示例:以下代码放在凭据校验成功后的登录处理逻辑中,项目已经接入 Sa-Token 并处于正常请求上下文。

java
long userId = 10001L;

// 设备类型必须来自服务端可控的终端分类,不要让客户端随意制造新类型。
StpUtil.login(userId, "PC");

预期结果:若账号 10001 已有一个 PC 会话,再次以 PC 登录时,默认策略会让旧 PC 会话进入被替换状态,新 PC 会话登录成功;该账号已有的 APP 会话不受影响。

同端互斥登录时旧会话、新会话与其他设备类型的状态变化

观察旧登录为什么失效

旧端再次访问需要登录的接口时,Sa-Token 会把它识别为已被顶下线,而不是普通的 Token 过期。常见处理方式是在统一异常处理中识别 NotLoginException.BE_REPLACED,向客户端提示“账号已在同类型设备重新登录”,再引导用户重新认证。

这里要区分三个状态:新端登录成功、同类型旧端失效、其他设备类型保持不变。若新登录后 APP 也掉线,优先检查项目是否把替换范围改成了全部设备;若两个 PC 都继续在线,则检查 is-concurrent 是否真正生效,以及两次登录传入的设备类型是否一致。

什么时候要改默认替换策略

默认行为是“新登录成功,旧设备下线”。较新的 Sa-Token 版本还允许通过 replacedLoginExitMode 改成拒绝新登录、保留旧会话。两种策略解决的是不同业务问题:共享账号场景通常更适合阻止新登录,个人账号更常见的是让最新一次登录接管。

无论选择哪种策略,设备类型必须稳定且由服务端约束。如果今天写 PC、明天写 WEB,框架会把它们当成两个不同类型,同端互斥就失去业务意义。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置同端互斥登录规则

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通