Redis连接空闲后收不到数据主因是防火墙/NAT静默丢包,须主从节点均配置tcp-keepalive 300并重启生效;该参数控制空闲300秒后发首探,不读取内核参数,需ss -tnp验证timer列是否显示keepalive。

Redis 连接空闲几分钟后突然收不到数据或超时,大概率不是网络抖动,而是防火墙/NAT 静默丢包 —— 关键得配 tcp-keepalive,且必须主从双方都配、重启生效。
为什么改了系统级 net.ipv4.tcp_keepalive_* 还没用
Redis 不读取内核的 keepalive 参数,它自己控制 socket 的 SO_KEEPALIVE 行为。即使你调了 tcp_keepalive_time=60,Redis 进程若没显式启用保活,连接照样在防火墙超时(常见 300 秒)后被单向切断。
验证方式:ss -tnp | grep :6379,看 timer 列有没有 keepalive;没有就说明 Redis 没真正启用。
如何正确配置 tcp-keepalive 并避免误杀
这个值不是“心跳间隔”,而是“空闲多少秒后发第一个探测包”。设太小反而容易被云厂商限速或当成扫描流量:
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
tcp-keepalive 300是通用推荐:空闲 5 分钟后开始探测,后续每 60 秒一次(内核默认),3 次无响应断连 - 不能只配主节点或只配从节点,主从
redis.conf都得有这一行,否则链路中间一端不发探测,整条连接仍会假活 -
CONFIG SET tcp-keepalive 300会报错 —— 该参数不支持热重载,必须改配置文件 +redis-server --config-file /etc/redis.conf重启 - 配完用
redis-cli CONFIG GET tcp-keepalive确认返回["tcp-keepalive","300"]
光配 tcp-keepalive 还不够,得协同 repl-timeout
tcp-keepalive 解决“连接是否断”,repl-timeout 解决“复制是否卡住”。如果 repl-timeout 小于 tcp-keepalive 周期,主节点可能在探测生效前就主动断开复制连接:
-
repl-timeout必须 ≥tcp-keepalive值,建议设为60或90(单位秒) - 同时检查
repl-ping-replica-period 10:主节点每 10 秒发一次REPLCONF ACK,这是复制层心跳,和 TCP 层不冲突但需配合 - Pub/Sub 场景还要额外设
timeout 600,防止服务器因空闲直接关掉订阅连接
客户端也得配 keepalive,逻辑和服务器不同
服务端 tcp-keepalive 保的是节点间链路;客户端(如 redis-py、ioredis、Lettuce)必须单独启用自己的 TCP keepalive,否则客户端→服务端这段仍可能无声断开:
- Python redis-py:构造
ConnectionPool时传socket_keepalive=True, socket_keepalive_options={...} - Node.js ioredis:配置
keepAlive: { enable: true } - Spring Boot Lettuce:
spring.redis.lettuce.keep-alive=true,且需搭配auto-reconnect=true - 注意:客户端 keepalive 参数(如空闲时间)通常要略小于服务端
tcp-keepalive,留出探测窗口
最容易被忽略的一点:所有配置项都必须写入 redis.conf 并重启,CONFIG REWRITE 不会持久化 tcp-keepalive,临时生效等于白配。


















