spring boot 3.x中redis连接池必须使用spring.data.redis.lettuce.pool前缀配置，否则参数无效；旧式spring.redis.lettuce.pool等写法被忽略，lettuce退化为默认max-active=8的无池直连，需通过启动日志和redis-cli client list验证实际生效。
Spring Boot 3.x 中 Redis 连接池必须用 spring.data.redis.lettuce.pool 前缀配置，否则参数完全无效 —— 这是启动不报错但连接池“形同虚设”的最常见原因。
为什么 spring.redis.lettuce.pool 配置不生效？
因为 Spring Boot 3.x 已废弃 spring.redis.* 命名空间，所有 Redis 相关配置统一收归 spring.data.redis.*。如果你仍沿用旧写法：
-
spring.redis.lettuce.pool.max-active: 16→ 被完全忽略，Lettuce 使用默认值（max-active = 8） -
spring.redis.pool.max-active: 16→ 1.x 风格配置，在 3.x 中彻底失效 - 漏写
lettuce二级节点（比如只写spring.data.redis.pool）→ Spring 不识别，连接池退化为无池直连
spring.data.redis.lettuce.pool 必配参数清单
以下参数必须显式声明，不能依赖默认值，否则高并发下容易触发连接耗尽或阻塞：
Redis 8.2.3
下载
Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行（RCE）的高危漏洞（CVE-2025-62507），并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级，以保障生产环境的系统稳定与数据安全。
-
max-active: 50—— 建议按公式估算：(峰值QPS × P99耗时秒数) × 1.2 + 5，低于 30 容易成为瓶颈 -
max-wait: 3000ms—— 必须设有限值！-1ms表示无限等待，会导致线程卡死、雪崩式超时 -
min-idle: 4—— 保持最小预热连接，避免冷启时批量建连抖动 -
max-idle: ${spring.data.redis.lettuce.pool.max-active}—— 通常设为max-active值，避免空闲连接过早回收
连接池参数实际生效的验证方式
光看配置不等于起作用，需通过运行时确认：
- 启动日志搜
LettuceConnectionConfiguration，应看到类似Creating LettuceConnectionFactory with pool config: maxActive=50 - 运行中执行
redis-cli client list | wc -l，连接数应稳定在min-idle ~ max-active区间，而非持续飙升 - 故意把
max-wait设成1ms，再压测 —— 若抛出LettuceConnectionException: Unable to acquire connection，说明参数已生效
别忽略 Lettuce 的 ClientResources 共享机制
Lettuce 默认复用底层 ClientResources（含线程池、DNS 缓存等），但自定义 RedisConnectionFactory 时若重复 new，会绕过共享导致资源泄漏：
- 错误写法：
new LettuceConnectionFactory()多次调用 → 创建多个 Netty EventLoopGroup - 正确做法：让 Spring 管理单例
ClientResources，或显式注入共享实例 - 更稳妥的方式：不手动 new，直接依赖自动装配的
RedisConnectionFactoryBean
连接池参数只是表象，真正决定稳定性的，是底层资源是否被正确复用 —— 这一点在容器化部署和多实例场景下极易被忽视。
