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+）：

  @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. 生产环境建议：在测试环境验证版本组合的稳定性

参考资源

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

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