spring boot 2.7 与 3.x 集成 redis 存在结构性断裂：配置前缀必须从 spring.redis 改为 spring.data.redis，jedis 被彻底移除、仅支持 lettuce，连接池路径同步迁移至 spring.data.redis.lettuce.pool，且需 jdk 17+ 与 spring-data-redis 主版本严格对齐。

Spring Boot 2.7 和 3.x 集成 Redis 的配置差异不是“微调”，而是结构性断裂——不改配置前缀、不换客户端、不升级 JDK，直接启动就会报错。

spring.redis vs spring.data.redis 配置前缀必须改

Spring Boot 2.7 使用 spring.redis 前缀；Spring Boot 3.x 强制使用 spring.data.redis。两者互不兼容，且 Spring Boot 3.x 的 RedisProperties 类已完全移除 spring.redis.* 的绑定逻辑。

• 2.7 正确写法：spring.redis.host、spring.redis.port、spring.redis.lettuce.pool.max-active
• 3.x 正确写法：spring.data.redis.host、spring.data.redis.port、spring.data.redis.lettuce.pool.max-active
• 如果在 3.x 中继续用 spring.redis，应用能启动但连接参数全失效，默认连 localhost:6379，密码、超时、池参数全部丢弃

Jedis 已被彻底移除，Lettuce 是唯一选择

Spring Boot 2.7 支持通过 spring.redis.client-type=jedis 切换客户端；Spring Boot 3.x 的 RedisAutoConfiguration 根本不加载 Jedis 相关类，硬编码只构建 LettuceConnectionFactory。

Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

• 2.7 中 spring.redis.client-type=jedis 有效，jedis 相关 pool 参数（如 spring.redis.jedis.pool.max-active）会被读取
• 3.x 中设置 spring.data.redis.client-type=jedis 完全无作用，启动时会警告 “Unknown property”，Jedis 依赖即使存在也会被忽略
• 3.x 必须用 Lettuce，且连接池配置必须走 spring.data.redis.lettuce.pool.*，spring.redis.lettuce.pool.* 在 3.x 中无效

连接池配置路径随命名空间整体迁移

不是只改前缀，而是整个配置层级重排。2.x 的 spring.redis.lettuce.pool 在 3.x 变成 spring.data.redis.lettuce.pool，中间多了一层 data。

• 2.7 兼容写法：spring.redis.lettuce.pool.max-wait=3000ms
• 3.x 唯一有效写法：spring.data.redis.lettuce.pool.max-wait=3000ms
• 旧项目升级时，IDE 搜索替换 spring.redis. → spring.data.redis. 是最安全的起点，但要人工核对所有 lettuce 或 jedis 子路径是否同步迁移
• 特别注意：spring.redis.pool.*（1.x 风格）在 2.7 和 3.x 中都无效，属于历史残留，别留着

版本对齐是硬性前提，不是可选项

Spring Boot 2.7.x 只能搭配 spring-data-redis 2.7.x；Spring Boot 3.x（如 3.3.0）必须用 spring-data-redis 3.x。混搭会导致 ClassNotFoundException 或 BeanCreationException，比如找不到 LettuceClientConfigurationBuilder 或 RedisUri。

• 查当前实际版本：运行 mvn dependency:tree | grep redis，确认 spring-data-redis 主版本号与 Spring Boot 主版本严格一致
• Spring Boot 3.x 要求 JDK 17+，若还在用 JDK 8/11，连编译都过不去，更别说运行时加载 Lettuce 的 Netty 4.1.100+ 依赖
• 升级不是改几行 YAML 就完事——它是 JDK、Spring Boot、spring-data-redis、Lettuce、Netty 的五层联动，漏一层就卡死

最常被跳过的动作：没检查 application.yml 里是否残留了 spring.redis.jedis 或 spring.redis.pool 这类已失效配置，它们不会报错，但会让连接池参数静默失效，最终表现为高并发下 Redis 连接耗尽或超时飙升。