> 技术文档 > redisson-spring-boot-starter 版本选择_redisson-spring-boot-starter版本

redisson-spring-boot-starter 版本选择_redisson-spring-boot-starter版本

以下是更详细的 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+):
    @Beanpublic 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. 生产环境建议:在测试环境验证版本组合的稳定性

参考资源

  • Redisson 官方兼容性矩阵
  • Spring Boot 官方依赖版本
  • Maven 中央仓库 - Redisson

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