典型现象是Redis从节点反复断连,日志出现“Client closed connection due to output buffer limit”,INFO replication中状态在connect→sync→disconnected循环;主节点因输出缓冲区超限(默认slave 256MB/64MB/60s)主动断开连接。

client-output-buffer-limit 触发强制断连的典型现象
Redis 从节点反复断开主节点连接、日志里频繁出现 Client closed connection due to output buffer limit,同时主节点 INFO replication 中看到从节点状态在 connect → sync → disconnected 之间循环——这不是网络问题,也不是认证失败,而是主节点主动踢掉了从节点。
这是因为主节点对每个客户端(包括从节点)设置了输出缓冲区上限,一旦从节点拉取 RDB 过慢、或网络卡顿导致积压未发送数据超过阈值,主节点就会直接关闭连接,不给重试机会。
关键点:这个限制默认只对 slave 类型客户端生效,且阈值极低(client-output-buffer-limit slave 256mb 64mb 60),意思是:缓冲区超 256MB 或连续 60 秒内积压超 64MB 就断连。
如何确认是 output buffer 导致的断连
先别急着调大参数,先验证是不是它:
- 在主节点执行
CLIENT LIST,找从节点对应的 client 行,看 omem 字段是否持续接近甚至超过 64MB
- 查主节点日志,grep
"output buffer" 或 "client closed",确认错误信息匹配 output buffer limit
- 用
redis-cli -h 主IP info clients 查 client_longest_output_list,若该值长期 > 0,说明有客户端输出队列积压
注意:CLIENT LIST 的 qbuf 是输入缓冲区(无关),真正要看的是 omem(输出内存占用)。
调整 client-output-buffer-limit 的安全方式
不能无脑加到 10G,得结合从节点实际带宽和 RDB 大小来设:
- RDB 文件约 2GB、从节点上行带宽稳定在 20MB/s,那么传输完至少需 100 秒 ——
time 参数必须 ≥ 120
- 缓冲区软限制(第二个值)建议设为 RDB 大小的 1.5 倍,比如 3GB;硬限制(第一个值)可设为软限的 2 倍,即 6GB
- 命令示例:
CONFIG SET client-output-buffer-limit "slave 6gb 3gb 120"
- 务必同步写入
redis.conf,否则重启后恢复默认值
⚠️ 风险提示:调太大可能撑爆主节点内存(尤其是多从节点并发同步时),omem 是每个从节点独立计算的。
比调参更治本的三个动作
参数只是兜底,真正减少触发概率得从链路入手:
- 启用
repl-diskless-sync yes,避免主节点把 RDB 写磁盘再读取发送,直接 socket 发送,大幅降低缓冲区积压风险
- 确保从节点与主节点部署在同一内网(延迟
- 检查从节点磁盘 I/O 能力,
iostat -x 1 看 %util 是否长期 > 90%,RDB 接收写盘慢也会拖慢整个同步节奏
真正难处理的是「磁盘 I/O + 网络抖动 + 缓冲区阈值」三者叠加,单调一个参数往往压不住。
CLIENT LIST,找从节点对应的 client 行,看 omem 字段是否持续接近甚至超过 64MB"output buffer" 或 "client closed",确认错误信息匹配 output buffer limit
redis-cli -h 主IP info clients 查 client_longest_output_list,若该值长期 > 0,说明有客户端输出队列积压- RDB 文件约 2GB、从节点上行带宽稳定在 20MB/s,那么传输完至少需 100 秒 ——
time参数必须 ≥ 120 - 缓冲区软限制(第二个值)建议设为 RDB 大小的 1.5 倍,比如 3GB;硬限制(第一个值)可设为软限的 2 倍,即 6GB
- 命令示例:
CONFIG SET client-output-buffer-limit "slave 6gb 3gb 120" - 务必同步写入
redis.conf,否则重启后恢复默认值
omem 是每个从节点独立计算的。
比调参更治本的三个动作
参数只是兜底,真正减少触发概率得从链路入手:
- 启用
repl-diskless-sync yes,避免主节点把 RDB 写磁盘再读取发送,直接 socket 发送,大幅降低缓冲区积压风险
- 确保从节点与主节点部署在同一内网(延迟
- 检查从节点磁盘 I/O 能力,
iostat -x 1 看 %util 是否长期 > 90%,RDB 接收写盘慢也会拖慢整个同步节奏
真正难处理的是「磁盘 I/O + 网络抖动 + 缓冲区阈值」三者叠加,单调一个参数往往压不住。
repl-diskless-sync yes,避免主节点把 RDB 写磁盘再读取发送,直接 socket 发送,大幅降低缓冲区积压风险iostat -x 1 看 %util 是否长期 > 90%,RDB 接收写盘慢也会拖慢整个同步节奏

















