查询缓冲：大命令的内存账

客户端发来的命令要先在服务端拼装成完整请求才能执行，这部分内存记在客户端头上，称为查询缓冲。当单条命令的参数特别多、特别大时（例如一次传入几万个字段的批量写），查询缓冲会瞬间抬高进程内存。client-query-buffer-limit 限制单个客户端查询缓冲的上限，默认 1gb，超过就断开该连接；proto-max-bulk-len 则限制单个批量字符串的最大长度，默认 512mb，超限直接返回协议错误。

基本信息

典型使用场景

• 批量导入脚本导致内存告警，需要确认贡献方是不是查询缓冲
• 线上出现协议错误断开，核对是否触及单值长度限制
• 设计批量写入方案时评估批次大小与内存影响
• 排查连接被意外断开，用 CLIENT LIST 的缓冲字段定位客户端
• 为共用实例设置更严格的查询缓冲上限，保护整体可用性
• 评估把大批量导入拆分成多批的改造收益

查看与核对

redis-cli CONFIG GET client-query-buffer-limit   # 单连接查询缓冲上限
redis-cli CONFIG GET proto-max-bulk-len           # 单值最大长度
redis-cli INFO clients | grep -E 'client_recent_max_input_buffer'
redis-cli CLIENT LIST | grep -E 'qbuf'            # 连接级缓冲占用
redis-cli INFO memory | grep -E 'used_memory:'    # 整体内存走势
redis-cli MONITOR                                 # 短窗口抓现场，慎用

两类限制对照