Spring Boot 3.x连接池不生效本质是配置前缀错误：应使用spring.data.redis.lettuce.pool.max-active而非spring.redis.lettuce.pool.max-active，否则参数被忽略而沿用默认值8；同时需排除Jedis依赖、校验Redis服务端协议兼容性（如设RESP2）、确保timeout与max-wait合理，并验证LettuceConnectionFactory是否成功初始化。
Connection pooling failed 本质是 Lettuce 或 Jedis 拿不到可用连接，不是配置写错了，而是连接池被耗尽、拒绝或初始化失败。直接换连接池参数治标不治本，得先定位是哪一层断了。
连接池参数没生效？检查 Spring Boot 版本前缀是否写错
Spring Boot 3.x 起，Redis 配置前缀从 spring.redis 改为 spring.data.redis。如果还用老写法，所有 lettuce.pool.* 或 jedis.pool.* 都会被忽略，连接池实际按默认值（比如 max-active=8）启动，极易打满。
- 错误写法（Boot 3.x 下无效）：
spring.redis.lettuce.pool.max-active=16 - 正确写法（Boot 3.x）：
spring.data.redis.lettuce.pool.max-active=16 - Boot 2.x 仍可用
spring.redis，但建议统一用spring.data.redis避免混淆
Lettuce 连接池卡死？优先关闭 Jedis 并确认 Lettuce 协议兼容性
Spring Boot 2.3+ 默认用 Lettuce，但如果你手动引入了 spring-boot-starter-data-redis 之外的 jedis 依赖，会触发自动配置冲突，导致连接池初始化失败或行为异常。
- 删掉显式声明的
redis.clients:jedis依赖，只保留spring-boot-starter-data-redis - 若 Redis 服务端是 5.x 或更早版本（如阿里云 Redis 5.0），Lettuce 6.x 默认启用 RESP3 协议，而老版 Redis 不支持 —— 表现为连接池反复尝试建连失败，日志里出现
NOAUTH Authentication required或<unresolved></unresolved> - 强制降级协议：在
application.yml中加spring.data.redis.lettuce.client-options.protocol-version=RESP2
连接池耗尽却无报错？检查 timeout 和 max-wait 设置是否合理
连接池满时，Lettuce 默认阻塞等待（max-wait），但若设为负数（如 -1）或 0，会立即抛 PoolException: Could not get a resource from the pool；若设得过大（如 30s），线程会卡住，拖垮整个应用。
-
spring.data.redis.timeout是单次命令超时，单位毫秒，不能为 0（否则底层解析失败）→ 推荐设为5000 -
spring.data.redis.lettuce.pool.max-wait是获取连接的等待上限 → 推荐设为1s（即1000ms），避免线程长期挂起 -
max-active不宜盲目调高，Lettuce 是基于 Netty 的非阻塞客户端，过高反而增加调度压力 → 多数场景16足够，压测后再调
连接池根本没初始化？验证 Redis 服务端可连且配置匹配
连接池失败常是上游问题的表象。比如 host 解析失败、password 错误、或 Redis 启用了保护模式，会导致 Lettuce 连不上，自然无法构建连接池。
- 用
redis-cli -h <host> -p <port> -a <password> ping</password></port></host>手动测试，确认能返回PONG - 检查 Redis 配置文件
redis.conf：确保protected-mode no，且bind行被注释（或明确包含你的应用所在 IP） - 若密码含特殊字符（如
+、/），必须用双引号包裹：password: "my@pass+word" - Spring Boot 启动日志里搜
LettuceConnectionFactory，看是否打印了Initializing Redis connection factory—— 没这句说明配置根本没加载
真正卡住的地方往往不在连接池参数本身，而在 DNS 解析失败、协议不匹配、或配置前缀失效这类“看不见”的链路断点。每次改完配置，务必重启应用并盯紧启动日志里的连接工厂初始化行和首次 Redis 操作的堆栈，才能避开盲区。
