Spring Security并发会话控制不生效:Redis存储场景报RedisConnectionFactory缺失错误
Spring Session + Spring Security 并发会话场景下RedisConnectionFactory缺失报错解决
核心报错原因
你遇到的Caused by: java.lang.IllegalStateException: RedisConnectionFactory is required,并非HttpSecurity中并发会话的配置逻辑有误,而是Redis存储类型的Spring Session自动装配链路被破坏:负责提供按用户名索引会话能力的FindByIndexNameSessionRepository在初始化时,无法获取到必须的Redis连接工厂实例,直接中断了Bean创建流程。
可直接落地的排查与修复步骤
- 第一步:确认核心依赖无缺失
仅引入基础的Spring Security、Spring Web依赖无法触发Redis会话的自动配置,必须确保同时引入以下两个模块:
注意:如果缺少<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency> <dependency> <groupId>org.springframework.session</groupId> <artifactId>spring-session-data-redis</artifactId> </dependency>spring-session-data-redis模块,Spring容器中根本不会注册RedisIndexedSessionRepository(也就是FindByIndexNameSessionRepository的Redis实现类),后续的会话注册表初始化自然会因为找不到依赖的组件报错。 - 第二步:检查配置文件的冲突项
排查application.yml/properties中的配置,删掉会阻断自动装配的错误配置:- 不要强制将会话存储类型设置为非Redis值,比如错误配置
spring.session.store-type=none - 不需要手动添加
@EnableRedisHttpSession注解强行开启Redis会话,这个注解会绕过Spring Boot的自动装配逻辑,如果写注解时没有显式传入RedisConnectionFactory参数,就会直接触发当前的报错
正确的基础配置仅需保留以下内容即可:
spring: session: store-type: redis redis: flush-mode: on_save namespace: spring:session - 不要强制将会话存储类型设置为非Redis值,比如错误配置
- 第三步:修正自定义的会话注册表Bean定义
你之前配置中用到的sessionRegistry(),必须基于已经正常装配的FindByIndexNameSessionRepository来构造,不要手动空实现或者无关联创建。正确的Bean定义参考如下:
很多人踩坑的原因是,自己写的@Bean public FindByIndexNameSessionRepository<Session> sessionRepository(RedisConnectionFactory redisConnectionFactory) { // 显式传入Redis连接工厂,构造Redis索引会话仓库 RedisIndexedSessionRepository repository = new RedisIndexedSessionRepository(redisConnectionFactory); repository.setDefaultCookieSerializer(new DefaultCookieSerializer()); return repository; } @Bean public SessionRegistry sessionRegistry(FindByIndexNameSessionRepository<Session> sessionRepository) { // 使用Spring Security提供的官方适配实现,不要手动自己实现SessionRegistry接口 return new SpringSessionBackedSessionRegistry<>(sessionRepository); }sessionRegistry()方法没有关联已有的Redis会话仓库,反而触发了FindByIndexNameSessionRepository的二次初始化流程,此时初始化上下文里的连接工厂没有被传入,就会抛出RedisConnectionFactory is required的异常。 - 第四步:检查自动配置排除项
查看启动类上的@SpringBootApplication注解,有没有手动排除Redis和Session的自动配置类:
只要删掉这类错误的排除配置,Spring Boot就会自动完成Redis连接工厂、会话仓库的全链路装配。// 错误的排除配置示例,需要删除对应的排除项 @SpringBootApplication(exclude = { RedisAutoConfiguration.class, SessionAutoConfiguration.class })
内容的提问来源于stack exchange,提问作者Mark
相关产品推荐
相关产品推荐

