Spring Boot 3 升级后，RedisIndexedSessionRepository 无法自动注册、会话事件（如 SessionExpiredEvent）不触发、Redis 缺失主索引键等问题，根源在于配置方式变更——需改用 @EnableRedisIndexedHttpSession 并启用显式会话保存策略。
spring boot 3 升级后，`redisindexedsessionrepository` 无法自动注册、会话事件（如 `sessionexpiredevent`）不触发、redis 缺失主索引键等问题，根源在于配置方式变更——需改用 `@enableredisindexedhttpsession` 并启用显式会话保存策略。
在 Spring Boot 3（尤其是 3.2.0+）中，Spring Session 对 Redis 的支持已重构：旧版 @EnableRedisHttpSession 默认注册的是轻量级 RedisSessionRepository，它不支持索引查询与会话事件发布；而真正支持事件驱动和按用户主键（如 PRINCIPAL_NAME_INDEX_NAME）高效检索的组件是 RedisIndexedSessionRepository，其启用必须通过新注解显式声明。
✅ 正确配置步骤如下：
1. 替换启用注解
删除 @EnableRedisHttpSession，改为使用：
@Configuration
@EnableRedisIndexedHttpSession // ✅ 关键：自动注册 RedisIndexedSessionRepository 及事件监听基础设施
public class SessionConfig {
}
该注解会自动注入 RedisIndexedSessionRepository Bean，并注册 RedisOperationsSessionRepository.RedisSessionExpirationPolicy 和 RedisMessageListenerContainer，从而支持 SessionCreatedEvent、SessionDeletedEvent、SessionExpiredEvent、SessionDestroyedEvent 等全生命周期事件。
2. 配置 Spring Security 显式保存策略
默认情况下，Spring Security 3.2+ 要求显式调用 SecurityContextRepository.saveContext() 才持久化会话。若未配置，会导致会话写入 Redis 失败，进而使索引键（如 :index:org.springframework.session.FindByIndexNameSessionRepository.PRINCIPAL_NAME_INDEX_NAME）缺失，事件也无法触发。
在 SecurityFilterChain 配置中添加：
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
http
// ... 其他配置
.securityContext(securityContext -> securityContext
.requireExplicitSave(false) // ✅ 允许自动保存会话（等效于旧版行为）
);
return http.build();
}
⚠️ 注意：
requireExplicitSave(false)是关键。设为true时需手动调用SecurityContextRepository.saveContext()，否则会话不会落库，索引与事件均失效。
3. 监听会话事件（可选但推荐）
通过 Spring 的 @EventListener 即可接收事件，例如：
@Component
public class SessionEventListener {
@EventListener
public void onSessionCreated(SessionCreatedEvent event) {
System.out.println("Session created: " + event.getSession().getId());
}
@EventListener
public void onSessionExpired(SessionExpiredEvent event) {
System.out.println("Session expired: " + event.getSession().getId());
}
}
4. 验证 Redis 索引是否存在
启动应用并登录后，检查 Redis 中是否生成以下键：
-
spring:session:sessions:<sessionid></sessionid>（会话主体） -
spring:session:sessions:expires:<sessionid></sessionid>（过期标记） -
spring:session:expirations:<timestamp></timestamp>（过期时间桶） -
spring:session:index:org.springframework.session.FindByIndexNameSessionRepository.PRINCIPAL_NAME_INDEX_NAME（✅ 主索引，用于按用户名查会话）
若该索引键存在，说明 RedisIndexedSessionRepository 已正确生效；若仍缺失，请检查：
- 是否遗漏
@EnableRedisIndexedHttpSession -
spring.session.redis.namespace是否被意外覆盖导致键名冲突 - Redis 连接是否正常（可通过
RedisTemplate手动 set/get 测试）
? 总结：Spring Boot 3 不再兼容旧式 @EnableRedisHttpSession 的事件与索引能力。务必统一使用 @EnableRedisIndexedHttpSession + requireExplicitSave(false) 组合，这是启用完整会话管理（含事件、索引、安全集成）的唯一标准路径。
