redis服务端timeout参数控制空闲连接自动断开时间,即客户端连上后若连续n秒无任何命令,redis将单方面关闭socket;默认值0表示永不关闭,但pub/sub场景下易致订阅中断、消息堆积。

Redis服务端timeout参数到底控制什么
它不控制“连接建立超时”,而是控制“空闲连接自动断开时间”——即客户端连上后,如果连续N秒没发任何命令(PING、PUBLISH、SUBSCRIBE等都不算心跳),Redis就单方面关掉这个socket。默认值是0(永不关闭),但Pub/Sub场景下这恰恰埋下隐患:订阅连接本身不发命令,服务器5分钟后(timeout 300)直接断链,客户端却还“以为在线”,后续消息全丢。
常见表现包括:
-
INFO clients里connected_clients数稳定,但client_longest_output_list持续>1000——说明某订阅者卡死,消息在Redis内存里堆积 - 日志里看不到报错,但新消息就是收不到
- 连接数缓慢上涨,旧连接没释放,新连接不断建
必须同时改的两个服务端配置项
只调timeout不够,必须配对启用tcp-keepalive,否则中间网络设备(NAT、云防火墙)可能静默丢包,导致连接假死。
-
config set timeout 600:把空闲断连阈值拉到10分钟,给客户端留出重连窗口 -
config set tcp-keepalive 60:启用内核级TCP心跳,每60秒发一次ACK探测,能更快发现链路异常
这两个命令必须写入redis.conf持久化,否则Redis重启就失效。tcp-keepalive 0表示禁用,不能省略设置。
Lettuce客户端怎么配心跳和重连才真正生效
Spring Boot默认用Lettuce,但光设spring.redis.lettuce.auto-reconnect=true不行——它不主动发心跳,重连触发延迟高,订阅连接照样会断。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 启用客户端心跳:
spring.redis.lettuce.keep-alive=true(Spring Boot 2.3+) - 显式配置重连策略:
ClientOptions.builder().autoReconnect(true).disconnectedBehavior(ClientOptions.DisconnectedBehavior.RECONNECT_AND_QUEUE_COMMANDS) - 关键点:心跳必须发生在
StatefulRedisPubSubConnection上,不是主连接池里的任意连接;且onMessage()不能阻塞,否则EventLoop卡住,心跳也发不出
Jedis和Redisson用户容易漏的关键点
Jedis没有内置Pub/Sub心跳机制,必须手动轮询:jedis.ping()得在订阅线程里定期执行(比如每30秒一次),且要确保调用的是当前订阅连接,不是从连接池里随便拿一个。
Redisson用户除了关注timeout,还得检查dnsMonitoringInterval(默认5000ms),建议调到3000——某些云Redis会动态漂移VIP,纯靠TCP保活覆盖不了DNS缓存过期问题。
所有客户端都要注意:如果Redis地址是域名,JVM DNS缓存可能让客户端连到已下线IP,启动时加-Dsun.net.inetaddr.ttl=60强制刷新。
最常被忽略的其实是连接复用逻辑:每次新建RedisClient + connectPubSub()都会创建独立EventLoop,不复用就会OOM或Too Many Open Files。这不是超时问题,但会让超时配置失效得更彻底。










