Redisson与Spring Data Redis版本兼容性问题解析

在使用Redisson作为Spring Boot项目的Redis客户端时，开发者可能会遇到一个典型的堆栈溢出错误。这个问题的根源在于Spring Data Redis与Redisson的版本不兼容，具体表现为调用zAdd方法时出现无限递归。

问题现象

当开发者使用以下环境配置时：

• Spring Boot 2.3.5.RELEASE
• Spring Cloud Hoxton.SR9
• Redisson Spring Boot Starter 3.16.5

在调用Redis的有序集合(zSet)操作时，系统会抛出StackOverflowError异常。从堆栈跟踪可以看出，问题发生在DefaultedRedisConnection.zAdd方法的无限递归调用上。

根本原因分析

这个问题本质上是由于版本不匹配造成的。Spring Boot 2.3.x系列对应的Spring Data Redis版本是2.3.x，而项目中引入的redisson-spring-boot-starter:3.16.5默认包含了针对Spring Data Redis 2.5.x的适配器(redisson-spring-data-25)。

当版本不匹配时，Redisson的代理机制会出现问题，导致方法调用的无限递归。特别是对于zAdd这样的集合操作方法，这种递归会迅速耗尽栈空间，最终导致StackOverflowError。

解决方案

要解决这个问题，开发者需要确保Redisson的Spring Data适配器版本与项目中实际的Spring Data Redis版本严格匹配。具体操作如下：

1. 在项目的依赖管理中排除不匹配的适配器：

<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>3.16.5</version>
    <exclusions>
        <exclusion>
            <groupId>org.redisson</groupId>
            <artifactId>redisson-spring-data-25</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 添加正确版本的适配器依赖：

<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-data-23</artifactId>
    <version>3.16.5</version>
</dependency>

最佳实践建议

1. 版本对应关系：在使用Redisson时，务必检查Spring Data Redis的版本，并选择对应的Redisson适配器。一般来说：

   • Spring Data Redis 2.3.x → redisson-spring-data-23
   • Spring Data Redis 2.5.x → redisson-spring-data-25
   • Spring Data Redis 2.6.x → redisson-spring-data-26

2. 依赖检查：在引入Redisson相关依赖时，可以使用Maven的dependency:tree命令检查实际引入的依赖版本，确保没有版本冲突。

3. 测试验证：在修改依赖后，应对Redis的基本操作进行测试，特别是集合类操作，以确认问题已解决。

总结

Redisson作为强大的Redis客户端，在与Spring生态集成时需要特别注意版本兼容性。开发者应当了解Spring Data Redis的版本与Redisson适配器版本的对应关系，避免因版本不匹配导致的运行时错误。通过正确的依赖管理和版本控制，可以充分发挥Redisson的性能优势，同时保证系统的稳定性。

对于使用较老版本Spring Boot(如2.3.x)的项目，建议按照本文的方案进行调整，以确保Redis操作的正常执行。同时，在条件允许的情况下，考虑升级到更新的Spring Boot版本，可以获得更好的兼容性和功能支持。