redisson-spring-boot-starter 版本选择

发布于:2025-05-22 ⋅ 阅读:(22) ⋅ 点赞:(0)

以下是更详细的 Spring Boot 与 redisson-spring-boot-starter 版本对应关系,按照 Spring Boot 主版本和子版本细分:

1. Spring Boot 3.x 系列

3.2.x
  • 推荐 Redisson 版本3.23.1(最新稳定版,兼容 Redis 7.x)
  • 兼容 Redis 版本:6.x/7.x
  • Java 要求:Java 17+
3.1.x
  • 推荐 Redisson 版本3.22.0(适配 Spring Data Redis 3.1.x)
  • 注意:若需使用 Redis 8,建议升级至 3.23.1
3.0.x
  • 推荐 Redisson 版本3.20.1(初始适配版本)
  • 依赖说明:需排除冲突的 spring-boot-starter-data-redis

2. Spring Boot 2.7.x 系列

2.7.15 及以下
  • 推荐 Redisson 版本3.17.6(最终维护版本,兼容 Redis 6.x)
  • 兼容 Redis 版本:5.x/6.x
  • Java 要求:Java 8/11
2.7.0 - 2.7.10
  • 推荐 Redisson 版本3.16.2(稳定适配版本)
  • 注意:避免使用 3.17.0+,可能存在配置兼容性问题

3. Spring Boot 2.6.x 系列

2.6.14 及以下
  • 推荐 Redisson 版本3.16.2
  • 依赖冲突处理
    <dependency>
        <groupId>org.redisson</groupId>
        <artifactId>redisson-spring-boot-starter</artifactId>
        <version>3.16.2</version>
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-data-redis</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    

4. Spring Boot 2.5.x 系列

2.5.14 及以下
  • 推荐 Redisson 版本3.15.5
  • 兼容性:需配合 spring-data-redis 2.5.x
  • 注意:不支持 Redis 7.x

5. 特殊场景

Redis Sentinel/Cluster 模式
  • 所有版本:需额外配置 redisson.yaml 或 Java 配置类
  • 示例配置(3.23.1+):
    @Bean
    public RedissonClient redissonClient() {
        Config config = new Config();
        config.useClusterServers()
            .addNodeAddress("redis://node1:6379", "redis://node2:6379");
        return Redisson.create(config);
    }
    
Redis 8 支持
  • 必须使用 Redisson 3.23.1+
  • Spring Boot 兼容性:仅支持 3.1.x+

版本选择原则

  1. 优先使用官方推荐版本:Spring Boot 3.x → Redisson 3.23+;Spring Boot 2.7.x → Redisson 3.17+
  2. 避免跨大版本使用:如 Spring Boot 3.x 不要使用 Redisson 3.17.x(可能导致序列化错误)
  3. 验证依赖树:使用 mvn dependency:tree 检查是否存在 spring-data-redis 版本冲突
  4. 生产环境建议:在测试环境验证版本组合的稳定性

参考资源

如果需要特定版本的配置示例或问题排查方法,可以进一步说明具体场景。


网站公告

今日签到

点亮在社区的每一天
去签到