You need to enable JavaScript to run this app. Spring Security并发会话控制不生效:Redis存储场景报RedisConnectionFactory缺失错误
优惠活动
大模型
产品
解决方案
定价
更多

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
    
  • 第三步:修正自定义的会话注册表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的自动配置类:
    // 错误的排除配置示例,需要删除对应的排除项
    @SpringBootApplication(exclude = {
        RedisAutoConfiguration.class, 
        SessionAutoConfiguration.class
    })
    
    只要删掉这类错误的排除配置,Spring Boot就会自动完成Redis连接工厂、会话仓库的全链路装配。

内容的提问来源于stack exchange,提问作者Mark

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 16:54:05