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。
- 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 连接耗尽或超时飙升。
