lettuce连接池需显式配置spring.redis.lettuce.pool.max-active等参数才生效，否则默认无池直连，易导致连接耗尽；配置必须写全路径，且需结合服务端maxclients与系统ulimit协同调优。
最大连接数必须显式配置，Spring Boot 默认不启用连接池（Lettuce）或仅用极小默认值（如 max-active=8），不设等于放任连接耗尽风险。
spring.redis.lettuce.pool.max-active 配置生效的前提
Lettuce 是 Spring Boot 2.0+ 默认 Redis 客户端，但它的连接池功能是“按需启用”的：只有当你在配置中写了 spring.redis.lettuce.pool.* 的任意一项，Spring 才会自动构建带连接池的 LettuceClientConfiguration。否则它走的是无池直连模式（每个操作新建连接），极易触发 java.net.SocketException: Too many open files 或 Redis 服务端 maxclients 拒绝。
- 必须写全路径：
spring.redis.lettuce.pool.max-active，不能简写成spring.redis.pool.max-active（后者只对 Jedis 有效） - 若同时引入了
jedis依赖但未排除lettuce，Spring Boot 仍优先用 Lettuce；要切 Jedis 必须显式排除并声明依赖 - 配置值为负数（如
-1）表示不限制，但生产环境不建议——Redis 服务端maxclients有硬上限（默认 10000），盲目放开可能压垮服务端
Jedis 的 max-total 和 Lettuce 的 max-active 不可混用
两者参数名、含义和作用位置完全不同，强行复用配置会导致静默失效：
- Jedis 使用
spring.redis.jedis.pool.max-total（注意是max-total，不是max-active） - Lettuce 使用
spring.redis.lettuce.pool.max-active（注意是max-active） - 如果项目里同时存在
jedis和lettuce依赖，且配置了spring.redis.pool.max-active（无前缀），该配置会被忽略——Spring Boot 不识别这种“通用”写法 - 验证是否生效：启动时看日志是否有
Creating LettuceConnectionFactory with pool configuration；运行中调用redis-cli info clients观察connected_clients是否稳定在预期范围内
生产环境推荐值与常见误配
没有万能数值，需结合应用并发量、Redis 部署方式（单机/集群/哨兵）、服务端 maxclients 设置综合判断：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 单机 Redis（
maxclients=10000）+ 中等流量应用：设max-active=200~500，min-idle=20，避免冷启时连接创建风暴 - Redis 集群（多节点分片）：每个
LettuceConnectionFactory对应一个集群入口，max-active应按单节点承载能力设，而非总节点数乘积 - 高频短连接场景（如大量异步任务发 Redis 指令）：提高
max-wait（如2000ms）比盲目拉高max-active更安全，防止线程卡死 - 典型误配：
max-active=10000+min-idle=1000→ 启动即占满服务端连接，其他客户端无法接入
Java 配置方式下如何覆盖 YAML 配置
当需要动态计算连接数（例如根据 CPU 核数或 JVM 内存调整），或需设置 Lettuce 特有参数（如 ClientOptions、拓扑刷新），必须用 Java Config 替代纯 YAML：
@Bean
public LettuceConnectionFactory redisConnectionFactory() {
RedisStandaloneConfiguration config = new RedisStandaloneConfiguration("localhost", 6379);
config.setPassword(RedisPassword.of("pwd"));
GenericObjectPoolConfig> poolConfig = new GenericObjectPoolConfig();
poolConfig.setMaxTotal(300); // 对应 YAML 中的 max-active
poolConfig.setMinIdle(20); // 对应 min-idle
poolConfig.setMaxWait(Duration.ofMillis(2000)); // 对应 max-wait
LettuceClientConfiguration clientConfig = LettuceClientConfiguration.builder()
.commandTimeout(Duration.ofSeconds(2))
.clientOptions(ClientOptions.builder()
.pingBeforeActivateConnection(true)
.build())
.pool(poolConfig)
.build();
return new LettuceConnectionFactory(config, clientConfig);
}
注意：GenericObjectPoolConfig 的 setMaxTotal 才真正控制 Lettuce 连接池上限；YAML 中的 spring.redis.lettuce.pool.max-active 只在 Spring 自动装配时起作用，手动 new 的 LettuceConnectionFactory 完全不读取它。
最易被忽略的一点：连接池参数只是客户端一侧的“节流阀”，真正瓶颈常在 Redis 服务端的 maxclients 和操作系统级文件描述符限制（ulimit -n）。上线前务必确认这两项已同步调优，否则客户端配再大也连不上。
