Spring Boot 3.x响应式项目创建JedisConnectionFactory时出现GenericObjectPoolConfig类缺失的NoClassDefFoundError错误求助

看起来你遇到的问题核心是Spring Boot 3.x的Reactive Redis Starter默认使用Lettuce作为客户端，而非Jedis，再加上依赖配置不完整，导致运行时找不到GenericObjectPoolConfig类。我来一步步帮你解决：

一、核心问题分析 #

NoClassDefFoundError说明JVM在运行时找不到org.apache.commons.pool2.impl.GenericObjectPoolConfig，虽然你手动添加了commons-pool2依赖，但还有两个关键问题：

1. spring-boot-starter-data-redis-reactive默认集成Lettuce客户端，它不需要commons-pool2（依赖Netty的连接池实现），所以这个starter不会自动引入Jedis相关依赖。
2. 你没有显式引入Jedis的官方starter或依赖，导致Jedis本身的Jar包可能未被正确加入运行时Classpath——而Jedis是必须依赖commons-pool2来实现连接池的，这就造成了类缺失。

二、解决方案步骤 #

1. 修正Maven依赖配置

你需要先排除Lettuce依赖，再引入Spring Boot提供的Jedis Starter，这样Spring Boot的依赖管理会自动帮你匹配兼容的Jedis和commons-pool2版本，避免版本冲突。

替换你现有的Redis相关依赖为：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
    <!-- 排除默认的Lettuce客户端 -->
    <exclusions>
        <exclusion>
            <groupId>io.lettuce</groupId>
            <artifactId>lettuce-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- 引入Jedis的Spring Boot Starter，自动包含Jedis和commons-pool2的兼容版本 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis-jedis</artifactId>
</dependency>

注意：此时你可以移除手动添加的commons-pool2依赖，因为spring-boot-starter-data-redis-jedis会自动引入它，而且版本由Spring Boot Parent统一管理，兼容性更好。

2. 验证依赖有效性

运行Maven命令检查依赖树，确认Jedis和commons-pool2都被正确引入，且没有被意外排除：

mvn dependency:tree | grep -E "(jedis|commons-pool2)"

你应该能看到类似如下的输出（版本号会和Spring Boot 3.x匹配）：

[INFO] +- org.springframework.boot:spring-boot-starter-data-redis-jedis:jar:3.2.0:compile
[INFO] |  +- redis.clients:jedis:jar:4.4.6:compile
[INFO] |  \- org.apache.commons:commons-pool2:jar:2.12.0:compile

3. 清理并重新构建项目

执行以下命令清理本地缓存，重新下载依赖并构建，避免旧依赖的影响：

mvn clean install -U

-U参数会强制Maven更新所有快照和依赖元数据，确保你拿到的是最新的兼容依赖。

4. （可选）优化Redis连接池配置

既然用了Jedis，你可以在RedisConfig里显式配置连接池参数，让commons-pool2真正发挥作用，同时验证依赖是否生效：

@Bean
public JedisConnectionFactory jedisConnectionFactory() {
    RedisStandaloneConfiguration config = new RedisStandaloneConfiguration(redisHost, redisPort);
    if (redisPassword != null && !redisPassword.isBlank()) {
        config.setPassword(RedisPassword.of(redisPassword));
    }

    // 配置Jedis连接池
    JedisPoolConfig poolConfig = new JedisPoolConfig();
    poolConfig.setMaxTotal(15); // 最大连接数
    poolConfig.setMaxIdle(10);  // 最大空闲连接数
    poolConfig.setMinIdle(3);   // 最小空闲连接数
    poolConfig.setTestOnBorrow(true); // 借连接时验证有效性

    JedisClientConfiguration clientConfig = JedisClientConfiguration.builder()
            .usePooling()
            .poolConfig(poolConfig)
            .build();

    return new JedisConnectionFactory(config, clientConfig);
}

三、为什么之前的配置不行？ #

你之前只添加了spring-boot-starter-data-redis-reactive和commons-pool2，但：

• 这个Starter默认用Lettuce，不会引入Jedis的核心依赖，所以编译时可能因为IDE的临时依赖能通过，但运行时Jedis的类（包括依赖的池类）就缺失了。
• 手动添加的commons-pool2版本如果和Jedis不兼容，也会导致类加载失败，而用Spring Boot Starter能自动管理版本兼容性。

按照以上步骤调整后，启动项目应该就能解决NoClassDefFoundError的问题了。

内容来源于stack exchange