Spring Boot升级到2.5.0后Redis依赖版本冲突启动失败如何解决

数据老陈

2026-10-12

问题根因

依赖存在两个核心冲突：
1. 同时引入了两个版本的Spring Session类库：旧版spring-session 1.3.5.RELEASE和新版spring-session-data-redis 2.5.0，两个Jar包都包含RedisOperationsSessionRepository类，版本不兼容导致构造方法找不到
2. 旧版Spring Session 1.x 与 Spring Boot 2.5.x内置的Spring Data Redis 2.x版本API不兼容，旧版调用的getConfig方法签名在新版RedisConnection中已经变更

解决方案

按如下规则修改pom.xml依赖：

完全删除旧版spring-session依赖：Spring Boot 2.x之后Spring Session的Redis支持已经独立为spring-session-data-redis模块，不需要再引入旧的spring-session通用依赖
不需要手动指定spring-boot-starter-data-redis和spring-session-data-redis的版本号：Spring Boot 2.5.0的父POM已经内置了兼容的版本号，自动匹配不会出现冲突

修改后的最终依赖配置

<!-- Redis Session相关依赖，不需要指定版本号，由Spring Boot父POM统一管理 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.session</groupId>
    <artifactId>spring-session-data-redis</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

代码适配说明

如果你的代码中还在手动实例化RedisOperationsSessionRepository，需要做对应调整：
Spring Session 2.x中RedisOperationsSessionRepository已经被标记为弃用，替换为RedisIndexedSessionRepository，如果有手动构造Bean的代码，调整为如下写法即可：

@Bean
public RedisIndexedSessionRepository sessionRepository(RedisConnectionFactory redisConnectionFactory) {
    return new RedisIndexedSessionRepository(redisConnectionFactory);
}