必须显式配置client-output-buffer-limit,否则主从断连或订阅端被踢;replica推荐1073741824 536870912 60,pubsub至少33554432 8388608 60,normal一般无需调但长轮询需留意。

client-output-buffer-limit 配置项必须调,否则主从断连
Redis 主从同步或 Pub/Sub 场景下,如果 client-output-buffer-limit 限制太小,从节点或订阅客户端会因缓冲区溢出被强制断开连接——这不是偶发错误,而是确定性行为。默认值(如 normal 客户端硬限 256MB)在大 key 同步、批量推送时几秒就打满。
实操建议:
- 主从架构中,
client-output-buffer-limit replica必须显式调大,推荐设为1073741824 536870912 60(即硬限 1GB、软限 512MB/60s),避免 RDB 全量传输期间触发断连 - Pub/Sub 场景若存在慢消费者,
client-output-buffer-limit pubsub至少设为33554432 8388608 60(32MB/8MB/60s),否则消息积压直接踢掉订阅端 - 普通客户端(normal)一般无需调整,除非你用 Redis 做长轮询或流式响应;此时可适当放宽,但注意
maxmemory要预留足够空间防 OOM
Redis 7.0 起共享复制缓冲区让 replica 缓冲更省内存
Redis 7.0 引入共享复制缓冲区后,多个从节点不再各自维护独立的 output buffer,而是共用主节点上的全局缓冲区。这意味着即使你有 10 个从节点,client-output-buffer-limit replica 的配置也不再线性放大内存占用。
但注意:该优化只对命令传播阶段生效,全量同步(RDB 传输)仍走传统路径,所以 replica 缓冲限值依然要设得足够承接单次 RDB 文件大小(尤其当 RDB >500MB 时)。
验证是否启用共享缓冲:连接主节点执行 INFO replication,查看是否有 repl_backlog_active:1 且 repl_backlog_size 明显大于旧版本默认值(1MB)。
tcp-backlog 和内核 somaxconn 不匹配会导致连接丢包
tcp-backlog 是 Redis 自身 TCP 全连接队列长度,但它受 Linux 内核参数 net.core.somaxconn 约束。若 Redis 配置了 tcp-backlog 65535,而 sysctl net.core.somaxconn=128,实际生效的仍是 128,高并发建连时大量 SYN 请求会被内核静默丢弃,现象是客户端报 Connection refused 或超时,而非 Redis 日志报错。
必须同步调整:
- 修改
/etc/sysctl.conf:添加net.core.somaxconn = 65535 - 执行
sysctl -p生效 - 再重启 Redis,确认
INFO clients中connected_clients能稳定接近maxclients设置值
io-threads 开启后 client-output-buffer-limit 影响变小但不能忽略
Redis 6.0+ 启用多线程 IO(io-threads 4 + io-threads-do-reads yes)后,网络读写吞吐提升明显,客户端缓冲区积压概率下降。但这不等于可以删掉或注释掉 client-output-buffer-limit。
原因在于:IO 线程只加速数据从 socket 搬运到 Redis 内存的过程,而命令执行仍是单线程。一旦遇到慢命令(如 SORT 大集合)、Lua 脚本阻塞或持久化 AOF rewrite 占用 CPU,输出缓冲照样会堆积。此时若限制过严,照样断连。
所以即使开了多线程,replica 和 pubsub 的缓冲限值仍需按实际流量预估,不能依赖“反正 IO 快了就没事”。
真正容易被忽略的是:缓冲区限制生效后不会立刻报错,而是悄悄关闭连接,日志里可能只有 Client closed connection due to output buffer limit 这类提示,埋点监控若没覆盖 client disconnect 指标,问题会拖到主从延迟飙升才暴露。











