redisson-spring-boot-starter 版本选择

news2025/5/25 0:08:12

以下是更详细的 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+

版本选择原则

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