🚪单点登录实战：同端同账号互踢下线的最佳实践（Java 实现）

在日常开发中，单点登录（SSO）是后端开发者绕不开的课题。尤其是在多端共存的系统中，比如 PC Web + 移动 App，如何保证同一账号在同一端只能登录一次，是一个既常见又容易踩坑的需求。

今天我就从一名 Java 开发者的角度，分享一下我在项目中成功落地的 "同账号同端互踢登录" 方案，附带完整思路与可行性分析，适合直接拿去实战！

🎯 需求解析

假设我们的系统支持多端登录（比如 PC 和 App），用户可以：

在 PC 和 App 同时登录（互不影响）✅
但不能在两个 App 同时登录（比如一台 Android 手机 + 一台 iOS 手机）❌
或者在两个浏览器中同时登录 PC 端 ❌

一句话总结：同一账号，同一端，只允许一个在线会话，后登录者踢掉前登录者。

📌 技术选型

语言/框架：Java + Spring Boot
认证机制：JWT + Redis
会话管理：自定义 Redis Token 存储结构
踢人机制：Token 黑名单或替换旧 Token

🧠 核心思路

我们用伪代码先梳理一下核心逻辑：

markdown 复制代码

1. 用户登录后，生成 JWT Token，并在 Redis 中记录：
   Key: login:{端类型}:{用户ID}
   Value: 当前 Token

2. 每次新登录时，检查 Redis 中是否已有记录：
   - 如果有，说明同一端已有登录记录，踢掉旧会话
   - 如果没有，正常登录

3. 鉴权时校验 Token 是否为当前有效 Token（即 Redis 记录的 Token）
   - 若不一致，视为被踢出，强制下线

🧱 Redis 数据结构设计

假设用户 ID 为 123，端类型为 APP 或 PC：

makefile 复制代码

Key: login:APP:123
Val: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
TTL: 与 Token 有效期一致（如 2 小时）

实际项目中建议加上前缀如 sso: 来避免 Key 污染。

🛠 实现步骤

1️⃣ 登录时处理逻辑

ini 复制代码

String token = JwtUtil.generateToken(userId);
String redisKey = "login:" + clientType + ":" + userId;

// 覆盖旧的 Token
redisTemplate.opsForValue().set(redisKey, token, tokenExpireTime, TimeUnit.MINUTES);

2️⃣ Token 校验逻辑

在登录拦截器或过滤器中增加校验：

ini 复制代码

String tokenFromRequest = getTokenFromHeader();
String userId = JwtUtil.getUserId(tokenFromRequest);
String clientType = JwtUtil.getClientType(tokenFromRequest);

String redisKey = "login:" + clientType + ":" + userId;
String validToken = redisTemplate.opsForValue().get(redisKey);

if (!tokenFromRequest.equals(validToken)) {
    // 当前 Token 已被挤下线
    throw new LoginExpiredException("您的账号已在其他设备登录");
}

3️⃣ 踢人提示（前端配合）

前端收到 401 + 错误码（如 ACCOUNT_KICKED）时，提示用户被挤下线并跳转登录页。

✅ 可行性分析

维度	说明
性能	Redis 读写效率高，覆盖式写入、无需事务处理
安全	JWT + Redis 双重验证有效性，防止 Token 伪造
扩展性	支持多端扩展（Web、iOS、Android），只需增加 clientType
稳定性	即使服务重启，Redis 中仍保持登录状态

🔄 可选优化方向

Token 黑名单机制：避免短时间内旧 Token 滥用
监听过期事件：结合 Redis Key 过期事件清理无效状态
多端共存策略：允许 PC + App 同时在线，更贴合用户习惯

🧩 多端互踢策略的扩展

如果你希望 APP 和 PC 也只能有一个登录，可以将 Redis Key 设计为：

css 复制代码

Key: login:{userId}
Val: {clientType}:{token}

这样就会实现全端互踢，即无论在哪登录，都会踢掉其他所有端。

📎 总结回顾

实现"同账号同端互踢登录"并不复杂，关键在于：

Redis 构建会话唯一性
JWT 自带用户 ID + 客户端类型
每次校验与 Redis 中的 token 对比

这个方案在我们多个线上项目中已运行超过一年，稳定可靠，欢迎大家参考落地。

🧑‍💻 你可以这样做

✅ 支持 App + PC 同时在线
✅ 保证同端登录唯一性
✅ 提高账号安全性，避免共享账号

💬 如果你也遇到类似问题...

欢迎在评论区留言交流，或者点赞、收藏支持一下！技术的路上，我们一起精进 💪