lettuce连接池未生效的主因是缺少commons-pool2依赖，导致配置被静默忽略而退化为单连接；同时需检查timeout是否为0、timebetweenevictionrunsmillis是否合理，并移除lettuce不支持的testonborrow等无效参数。
配置写了但压测时连接数不涨、命令频繁超时，大概率是Lettuce连接池根本没生效——不是配错了，而是Spring Boot没读到或没用上。
检查spring.redis.lettuce.pool是否被正确加载
Spring Boot 2.x 默认启用 Lettuce，但lettuce.pool相关配置只在显式引入commons-pool2依赖后才真正生效。缺这个依赖，哪怕你写了一堆max-active、min-idle，Spring 也会静默忽略，退化为单连接模式。
- 确认
pom.xml中存在：<dependency><groupid>org.apache.commons</groupid><artifactid>commons-pool2</artifactid></dependency> - 启动日志里搜
LettucePoolingClientConfigurationBuilder，没出现说明连接池构建逻辑根本没走 - 用
redis-cli client list | wc -l观察真实连接数，持续稳定在1–2个，基本可断定池未启用
验证spring.redis.timeout是否设为0
设成timeout: 0看似“永不超时”，实则触发 Lettuce 底层的立即失败逻辑，导致连接建立阶段就报RedisConnectionException，后续所有命令自然超时。
- 错误配置：
spring.redis.timeout: 0→ 启动可能成功，但首次调用必失败 - 推荐值：
spring.redis.timeout: 3000（3秒），开发环境可放宽至5000，生产环境勿超10000 - 注意：这个
timeout控制的是命令执行超时，和连接池的max-wait无关，别混用
排查timeBetweenEvictionRunsMillis是否为负值或过大
这是最容易被忽略的“假生效”元凶。Lettuce 连接池空闲连接驱逐依赖该参数，若设为负数（如-1），驱逐线程不启动，空闲连接长期滞留；若设得太大（如3600000），连接可能在防火墙超时前就已失效，却无人清理。
- 默认值为
60000（1分钟），建议保持或微调为30000～120000 - Spring Boot 2.3+ 可通过
spring.redis.lettuce.pool.time-between-eviction-runs配置（单位毫秒） - 未显式配置时，部分版本会 fallback 到 Netty 默认行为，导致驱逐逻辑实际未启用
确认是否误用testOnBorrow类参数
Lettuce 不支持 Jedis 风格的testOnBorrow、testWhileIdle等参数。这些配置写进 yml 不报错，但完全无效，还会误导你认为“健康检测已开启”。
- 删掉所有含
test前缀的连接池配置项，例如：test-on-borrow、test-while-idle - 真要校验连接有效性，必须手动调用
LettuceConnectionFactory.validateConnection()（如定时任务中） - 更稳妥的方式是启用 Lettuce 的
ping-before-activate机制（需升级到lettuce-core≥ 6.1.0）
真正生效的连接池不是靠参数堆出来的，而是靠commons-pool2依赖、合理timeout、有效的驱逐周期，以及避开那些“看起来有用实则被忽略”的配置项。漏掉其中任意一环，都会让你在压测时看着监控里那条平直的连接数曲线发呆。
