client-query-buffer-limit不能全局统一设置，因Redis将客户端分为normal、replica、pubsub三类，各自缓冲区行为与风险不同，需分别配置hard-limit、soft-limit和soft-seconds参数。
直接调用 client-query-buffer-limit 是无效的——这个配置项必须按客户端类型分别设置，且不能只设一个值。
为什么 client-query-buffer-limit 不能全局统一设？
Redis 把客户端分三类：普通客户端（normal）、从节点（replica）、Pub/Sub 客户端（pubsub），每类的缓冲区行为和风险完全不同：
-
normal客户端通常发命令快、收响应快，缓冲区溢出多因应用 bug（如未读响应就发新命令） -
replica在全量同步时会持续接收 RDB 流，缓冲区极易撑满，尤其跨机房带宽受限时 -
pubsub客户端若消费慢、消息堆积多，缓冲区会线性增长，最终触发连接断开
所以 Redis 强制要求你为每类单独指定三个参数：hard-limit（硬上限）、soft-limit（软上限）、soft-seconds（软限持续时间）。超出 hard 就立即断连；软限则允许短时越界，超时才断。
怎么配 client-query-buffer-limit 才不丢连接又防爆？
推荐配置（适用于中等负载、跨机房主从场景）：
client-query-buffer-limit normal 1gb 512mb 60 client-query-buffer-limit replica 2gb 1gb 120 client-query-buffer-limit pubsub 32mb 8mb 60
说明：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
normal：设得宽松些（1GB），避免因临时批量命令（如 pipeline 发几百条）误杀连接；但 soft-limit 控制在 512MB 内，超 60 秒就断，防长期内存泄漏 -
replica：全量同步期间缓冲区增长最快，hard-limit 设为 2GB 更稳妥；soft-limit 给足 1GB + 120 秒，覆盖多数 RDB 传输窗口 -
pubsub：必须严格限制，32MB 硬上限防止消息风暴拖垮实例；8MB/60s 软限可容忍短暂积压
注意：client-query-buffer-limit 不支持运行时热改，必须写入 redis.conf 并重启生效（或用 CONFIG REWRITE 后 reload）。
如何确认某类客户端真被 buffer 限制干掉了？
查日志或监控指标最直接：
- 日志里出现
Client query buffer overflow或error: client query buffer limit reached—— 这是 hard-limit 触发 -
redis-cli info clients中看client_longest_output_list和client_biggest_input_buf，若持续接近你设的 soft-limit 值，说明有客户端长期卡住 - 用
redis-cli client list查具体连接的qbuf（输入缓冲区字节数）和qbuf-free（剩余空间），例如：qbuf=8388608,qbuf-free=0表示已满
别依赖 maxmemory 或 mem_fragmentation_ratio 来判断——query buffer 占用的是 Redis 进程堆内存，不计入 used_memory，爆了也不会触发淘汰策略。
真正难处理的是 replica 类型的缓冲区问题：它不报错、不告警，只默默断连重试，导致复制延迟毛刺。一旦发现 master_repl_offset - slave_repl_offset > 100MB，先盯 client-query-buffer-limit replica 配置是否合理。
