fix(登出): logout 此前只清 cookie——现写 machine 吊销标记且先于超管豁免

吊销必须挂在 assertSameDevice 之前:那条路径第一行就是 if (exempt) return;,
放它下面等于超管永不见吊销。也不能清空 machine(本类对空值是「尚未绑定=放行」语义)。
前缀避开 claude-*/e2e-*:users.machine 还被当测试号签名用。写值带 deviceId 做 CAS,
不把别处刚登录的新会话一起打死。
This commit is contained in:
2026-10-09 14:48:11 +08:00
parent d349bc1a7d
commit 3f5f081cb5
4 changed files with 128 additions and 1 deletions
@@ -19,6 +19,15 @@ public final class DeviceSessionPolicy {
/** 账号已在其他设备登录(前端据此提示并下线本设备)。 */
public static final int CODE_KICKED = 4011;
/**
* 登出吊销标记:写进 {@code users.machine},让该设备已发的令牌下一请求即拒。
*
* <p>不能用「清空 machine」表达登出——本类对空 machine 是<b>放行</b>语义
* (尚未绑定不做限制,见 {@link #assertSameDevice}),清空只会放宽。前缀也必须与
* 测试号签名 {@code claude-*} / {@code e2e-*} 不重叠,否则清脏数据脚本会把已登出设备读成测试号。</p>
*/
public static final String REVOKED_PREFIX = "revoked@";
private DeviceSessionPolicy() {
}
@@ -108,6 +117,26 @@ public final class DeviceSessionPolicy {
}
}
/** 这张 machine 值是不是登出吊销标记。 */
public static boolean isRevoked(String machine) {
String value = machine == null ? "" : machine.trim();
return value.startsWith(REVOKED_PREFIX);
}
/**
* 吊销校验。<b>必须挂在 {@link #assertSameDevice} 之前调用</b>:那条路径第一行就是
* {@code if (exempt) return;}(超管豁免),把吊销放在它下面等于超管永不见吊销。
* 也不受 singleDevice 开关支配——登出了就该拒,与开关无关。
*/
public static void assertNotRevoked(String storedMachine, Long userId, String username) {
if (isRevoked(storedMachine)) {
log.warn("[auth] 会话已登出被拒 userId={} username={}", userId, username);
// 文案沿用既有 401:客户端只按 401/409 分支,新文案会让它走未知路径
throw new BusinessException(401, "登录已过期,请重新登录");
}
}
/** 登录绑定时的中文日志:首次绑定 / 换设备(顶下线)/ 同设备重登,便于线上排查互踢来源。 */
public static void logBindOnLogin(String previousMachine, String deviceId, Long userId, String username) {
String previous = previousMachine == null ? "" : previousMachine.trim();