如何删除Redis中所有Spring Session或按条件管控清理无效会话

问题根因说明 #

你当前遇到的索引堆积性能问题，核心是Spring Session Redis默认实现的逻辑导致：主动调用deleteById删除会话时，默认只会删除会话本身的key，不会同步清理spring:session:index:*前缀对应的索引条目，哪怕登录时删除了旧会话，索引里仍然残留无效的用户与会话映射关系，长期积累后索引集合越来越大，findByPrincipalName的查询性能自然会下降。

可行优化方案 #

方案1：启用Spring Session自带索引清理机制 #

Spring Session 2.3及以上版本已经提供了官方的索引自动清理能力，开启后无论是会话过期还是主动调用deleteById删除，都会同步移除对应的索引条目，从根源避免无效索引堆积：

• 首先配置合理的会话过期时间，Redis会自动清理过期的会话key
• 开启索引自动清理开关即可

配置示例（application.yml）：

spring:
  session:
    redis:
      cleanup-indexes: true # 开启索引自动清理
      timeout: 1800 # 会话过期时间，单位秒，可根据业务需求调整

方案2：批量清理历史无效堆积数据 #

如果已经存在大量历史堆积的无效索引，可以通过定时任务批量清理：

1. 按lastAccessedTime筛选出超过指定时间未访问的会话，调用deleteById删除，开启索引自动清理的前提下会同步移除对应的索引
2. 也可以直接扫描所有索引集合，对比当前有效的会话ID列表，移除无效的映射条目

批量清理代码示例：

@Autowired
private FindByIndexNameSessionRepository<Session> sessionRepository;

@Autowired
private RedisTemplate<String, Object> redisTemplate;

// 清理超过7天未访问的无效会话
public void cleanExpiredSessions() {
    long expireThreshold = System.currentTimeMillis() - 7 * 24 * 60 * 60 * 1000;
    // 匹配所有会话key，默认前缀为spring:session:sessions:
    Set<String> sessionKeys = redisTemplate.keys("spring:session:sessions:*");
    if (CollectionUtils.isEmpty(sessionKeys)) {
        return;
    }
    for (String sessionKey : sessionKeys) {
        String sessionId = sessionKey.replace("spring:session:sessions:", "");
        Session session = sessionRepository.findById(sessionId);
        if (session == null || session.getLastAccessedTime().toEpochMilli() < expireThreshold) {
            sessionRepository.deleteById(sessionId);
        }
    }
}

可以将上述逻辑封装为定时任务，比如每周凌晨执行一次兜底清理即可。

方案3：优化现有会话管控逻辑 #

当前的登录清理旧会话逻辑可以做小幅调整，降低无效数据产生概率：

• 登录时调用findByPrincipalName拿到用户的旧会话列表后，逐个调用deleteById删除，开启索引自动清理的前提下，旧会话的索引会被同步移除，不会产生残留
• 如果业务不需要支持多端同时登录，可以直接限制同一个用户仅保留1个有效会话，每次创建新会话前完成旧会话清理，从源头减少会话生成数量

行业通用落地参考 #

• 中小流量场景直接用「Spring Session自带索引清理+定时任务兜底清理」的组合即可，足够覆盖性能需求
• 大流量场景可以额外增加一层本地缓存，存储用户当前的有效会话ID，减少直接调用findByPrincipalName查询Redis的次数，降低Redis压力
• 对会话可靠性要求极高的场景，可以自行维护用户与会话ID的映射关系，不使用Spring Session默认的索引结构，清理时可以直接操作映射集合，性能会更高

内容的提问来源于stack exchange，提问作者Sizzling