Spring Web项目集成Redis遇NoSuchMethodError错误求助

冲突定位 #

NoSuchMethodError 本质是类加载时找到的方法签名不匹配，结合你使用的版本，核心原因有两个：

• 版本兼容性不匹配：Spring Data Redis 2.3.x 系列（基于 Spring 5.2.x）官方适配的 Jedis 稳定版本是 3.2.0，Jedis 3.3.0 对部分内部方法做了调整，导致 spring-data-redis 调用的方法在该版本中不存在或签名变更。
• 依赖仲裁冲突：项目中其他依赖（比如 Spring Cloud 组件、第三方工具包）可能偷偷引入了更低版本的 Jedis（如 2.x/3.1.x），Maven 依赖仲裁机制选择了低版本，导致 spring-data-redis 无法找到所需方法。

具体解决方案 #

1. 降级 Jedis 到兼容版本 #

直接将 Jedis 版本改为 spring-data-redis 2.3.3 官方指定的 3.2.0，这是最稳妥的方案：

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>3.2.0</version>
</dependency>
<dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-redis</artifactId>
    <version>2.3.3.RELEASE</version>
</dependency>

2. 排查并解决依赖冲突 #

如果必须使用 Jedis 3.3.0，先执行 Maven 命令排查依赖树：

mvn dependency:tree -Dverbose | grep jedis

找到所有引入 Jedis 的依赖项，若存在低版本，在对应的依赖中排除掉旧版本：

<!-- 示例：排除某依赖引入的低版本 Jedis -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>some-dependency</artifactId>
    <version>x.x.x</version>
    <exclusions>
        <exclusion>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
        </exclusion>
    </exclusions>
</dependency>

同时在 pom.xml 中明确锁定 Jedis 版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
            <version>3.3.0</version>
        </dependency>
    </dependencies>
</dependencyManagement>

注意：这种方式可能存在潜在兼容性风险，建议先测试核心 Redis 操作（连接、读写、序列化等）是否正常。

3. 检查 JedisConnectionFactory 配置 #

确认你的 JedisConnectionFactory 配置没有使用 Jedis 3.3.0 移除的 API，改用 spring-data-redis 2.3.x 支持的方式：

@Bean
public JedisConnectionFactory jedisConnectionFactory() {
    RedisStandaloneConfiguration config = new RedisStandaloneConfiguration("localhost", 6379);
    // 若有密码或库配置
    config.setPassword(RedisPassword.of("your-password"));
    config.setDatabase(0);
    
    JedisClientConfiguration clientConfig = JedisClientConfiguration.builder()
            .usePooling()
            .poolConfig(new JedisPoolConfig())
            .build();
    
    return new JedisConnectionFactory(config, clientConfig);
}

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