Spring Data Redis升级Jedis版本导致NoSuchMethodError问题解析

问题背景

在Spring Boot 3.5.0发布后，部分开发者在使用Spring Data Redis时遇到了一个运行时错误。当调用RedisTemplate的setIfAbsent方法时，系统抛出NoSuchMethodError异常，提示找不到SetParams.ex(long)方法。这个问题在Spring Boot 3.5.0-RC1版本中并不存在，但在正式版中突然出现。

错误现象

开发者在使用RedisTemplate进行键值操作时，特别是调用setIfAbsent方法并设置过期时间时，会遇到如下错误栈：

java.lang.NoSuchMethodError: 'redis.clients.jedis.params.BaseSetExParams redis.clients.jedis.params.SetParams.ex(long)'

这个错误表明在运行时，JVM无法找到Jedis客户端库中SetParams类的ex方法。

原因分析

经过深入调查，发现这个问题的根源在于Spring Boot 3.5.0中Jedis客户端的版本变更。具体来说：

1. 在Spring Boot 3.5.0-RC1中，使用的是Jedis 5.x版本
2. 而在Spring Boot 3.5.0正式版中，Jedis被降级到了5.2.0版本
3. Jedis 5.2.0版本中SetParams类的API发生了变化，移除了ex(long)方法

这种向后不兼容的API变更导致了运行时错误。Spring Data Redis在代码中调用了这个已被移除的方法，因此当使用Jedis 5.2.0时就会抛出NoSuchMethodError。

解决方案

Spring团队已经确认将在Spring Boot 3.5.1版本中升级Jedis到6.0.0版本来解决这个问题。对于当前遇到此问题的开发者，有以下几种临时解决方案：

1. 显式指定Jedis版本：在项目中明确声明使用Jedis 6.0.0版本

   <dependency>
       <groupId>redis.clients</groupId>
       <artifactId>jedis</artifactId>
       <version>6.0.0</version>
   </dependency>
   

2. 等待官方修复：等待Spring Boot 3.5.1发布，该版本将默认使用Jedis 6.0.0

3. 回退到RC版本：临时使用Spring Boot 3.5.0-RC1版本（不推荐用于生产环境）

技术建议

对于依赖管理，建议开发者：

1. 在重要版本升级前，充分测试所有Redis相关功能
2. 对于生产环境，考虑显式指定关键依赖的版本号
3. 关注Spring Boot的发布说明，了解依赖库的版本变更

总结

这个案例展示了依赖管理在Java项目中的重要性。即使是微小的版本变更，也可能因为API不兼容导致运行时错误。Spring团队已经意识到这个问题，并将在下一个补丁版本中通过升级Jedis版本来解决。在此期间，开发者可以通过显式指定Jedis版本来规避这个问题。