Lettuce默认不保活连接，因其基于Netty且未显式启用TCP keepalive或PING机制，导致空闲连接被中间设备静默关闭；需手动配置pingBeforeActivateConnection、拓扑刷新及合理连接池参数来解决。
为什么Lettuce默认不保活连接
Lettuce 作为 Spring Boot 2.x+ 的默认 Redis 客户端，本身是基于 Netty 的非阻塞连接，它不主动发送 PING 或维持 TCP keepalive（除非显式开启），导致中间网络设备（如 NAT、云厂商 SLB、防火墙）在空闲 60–300 秒后静默关闭连接。下次请求时，io.lettuce.core.RedisCommandTimeoutException: Command timed out after 5 second(s) 就会抛出——不是 Redis 挂了，而是连接早就被掐断了。
用 lettuce 自带拓扑刷新 + 心跳检测保活
不用换 Jedis，Lettuce 完全能解决，关键是打开它的自适应拓扑刷新和连接验证机制。核心是配置 LettuceClientConfiguration 并注入自定义 LettuceConnectionFactory：
- 在
@Configuration类中创建LettuceConnectionFactoryBean，不要依赖自动配置 - 启用
ClientOptions.builder().autoReconnect(true).pingBeforeActivateConnection(true) - 设置
ClientResources的dnsResolver和discoveryClient（如果用哨兵或集群） - 最关键：开启拓扑刷新，避免节点 IP 变更后无法重连：
ClusterTopologyRefreshOptions topologyRefreshOptions = ClusterTopologyRefreshOptions.builder() .enablePeriodicRefresh(Duration.ofSeconds(30)) .enableAllAdaptiveRefreshTriggers() .build(); clientOptions = ClientOptions.builder() .topologyRefreshOptions(topologyRefreshOptions) .build();
validateConnection 不生效的常见原因
validateConnection 是 GenericObjectPoolConfig 的一个开关，但它只对连接从池中取出时是否执行 PING 起作用——前提是底层连接工厂真调用了它。Lettuce 的默认实现并不触发该验证，所以光配 spring.redis.lettuce.pool.test-on-borrow=true 没用。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
真正起效的方式只有两种：
- 手动在业务代码里加
redisTemplate.getConnectionFactory().getConnection().ping()（适合定时健康检查） - 用
pingBeforeActivateConnection(true)（推荐，Lettuce 原生支持，每次取连接前自动发 PING） - 注意：若 Redis 配了密码，
pingBeforeActivateConnection会失败，必须确保RedisURI中已含auth字段，或使用RedisStandaloneConfiguration显式设setPassword()
别忽略连接池参数与超时协同配置
即使心跳开了，如果连接池参数不合理，照样会卡住或频繁重建连接。重点看这三组值是否匹配：
-
spring.redis.timeout=3000（命令级超时）应 ≤spring.redis.lettuce.pool.max-wait=2000（获取连接最大等待） -
spring.redis.lettuce.pool.max-idle和min-idle要结合 QPS 设置；低流量服务设min-idle=1可避免首次请求冷启动延迟 -
spring.redis.lettuce.pool.max-active不宜盲目调高，Lettuce 单连接可复用多命令，通常 8–20 足够；过高反而触发 Redis 的maxclients限制
最易被忽略的是：lettuce 的连接池配置项前缀是 spring.redis.lettuce.pool，不是 spring.redis.jedis.pool —— 写错前缀等于没配。
