Spring Boot 2迁移JedisPool遇JedisConnectionFactory Bean缺失问题求助

这个问题我之前做版本迁移时也碰到过，结合你给出的报错信息，咱们一步步拆解根源和解决方案：

问题核心原因 #

Spring Boot 2.x对Redis自动配置逻辑做了调整：JedisConnectionConfiguration类里的redisConnectionFactory Bean被@ConditionalOnMissingBean(type = "org.springframework.data.redis.connection.RedisConnectionFactory")修饰——意思是只要容器里存在任何一个RedisConnectionFactory类型的Bean，自动配置的JedisConnectionFactory就不会被创建。而你的getJedisPool方法明确依赖JedisConnectionFactory类型的Bean，这就导致了依赖缺失的报错。

另外，Spring Boot 2.x默认改用Lettuce作为Redis客户端，如果你没明确引入Jedis依赖，自动配置也不会触发Jedis相关Bean的创建。

具体解决方案 #

1. 确保正确引入Jedis依赖 #

先检查你的依赖配置（Maven/Gradle），必须同时引入Spring Data Redis starter和Jedis依赖：

<!-- Maven依赖示例 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
</dependency>

2. 检查自定义Redis配置类 #

如果项目里有自定义的Redis配置类，分两种情况处理：

• 如果你不需要自定义RedisConnectionFactory，直接删掉相关的Bean定义，让Spring Boot自动创建JedisConnectionFactory；
• 如果必须自定义，要确保你的Bean是JedisConnectionFactory类型，或者调整条件注解避免覆盖自动配置。示例代码：

@Configuration
public class ApplicationConfig {

    // 手动创建匹配类型的JedisConnectionFactory
    @Bean
    public JedisConnectionFactory jedisConnectionFactory(RedisProperties redisProperties) {
        JedisConnectionFactory factory = new JedisConnectionFactory();
        factory.setHostName(redisProperties.getHost());
        factory.setPort(redisProperties.getPort());
        factory.setPassword(redisProperties.getPassword());
        factory.setDatabase(redisProperties.getDatabase());
        
        // 配置连接池参数
        JedisPoolConfig poolConfig = new JedisPoolConfig();
        poolConfig.setMaxTotal(redisProperties.getJedis().getPool().getMaxActive());
        poolConfig.setMaxIdle(redisProperties.getJedis().getPool().getMaxIdle());
        poolConfig.setMinIdle(redisProperties.getJedis().getPool().getMinIdle());
        factory.setPoolConfig(poolConfig);
        
        return factory;
    }

    // 现在可以正常注入JedisConnectionFactory
    @Bean
    public JedisPool getJedisPool(JedisConnectionFactory jedisConnectionFactory) {
        return (JedisPool) jedisConnectionFactory.getPool();
    }
}

3. 简化配置：利用自动配置的连接池 #

其实Spring Boot 2.x已经帮你自动配置好了JedisPool，完全不需要手动创建getJedisPool Bean，只要在配置文件里正确配置参数，直接注入JedisPool或RedisTemplate即可：

# application.properties示例
spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=your-password
spring.redis.database=0
# Jedis连接池配置
spring.redis.jedis.pool.max-active=20
spring.redis.jedis.pool.max-idle=10
spring.redis.jedis.pool.min-idle=2
spring.redis.jedis.pool.max-wait=2000ms

最后排查点 #

如果项目里有第三方库或自定义代码创建了RedisConnectionFactory类型的Bean，自动配置的JedisConnectionFactory会被跳过。这时候你要么修改该Bean的类型为JedisConnectionFactory，要么手动创建JedisConnectionFactory Bean来满足getJedisPool的依赖。

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