调优 client_body_buffer_size 的核心目标是让 Nginx 在内存中缓存完整请求体以避免磁盘 IO；它仅控制请求体初始内存缓冲，需结合典型大小、并发数与可用内存权衡设定，并配合 client_max_body_size、client_body_in_file_only 等指令协同优化。

调优 client_body_buffer_size 的核心目标，是让 Nginx 尽可能在内存中缓存完整的请求体（如大文件上传、JSON 表单等），避免写入临时磁盘文件，从而减少系统 IO 开销和延迟。

理解 client_body_buffer_size 的作用边界

该指令仅控制 Nginx 接收客户端请求体（POST/PUT 等）时的初始内存缓冲区大小。它不作用于响应体，也不影响 header 或 URL 参数。当请求体超过该值且未启用 client_body_in_file_only off 时，Nginx 会将超出部分或整个 body 写入临时文件（由 client_body_temp_path 指定）。

• 默认值通常为 8k 或 16k，对小表单足够，但对几 MB 的上传明显不足
• 若设得过大（如 >128MB），可能造成 worker 进程内存占用陡增，尤其在并发上传多路时易触发 OOM
• 该 buffer 是 per-request 分配的，不是全局共享池，需按并发请求数预估总内存开销

合理设定 buffer 大小的关键依据

应结合业务典型请求体大小、并发连接数、可用内存三者动态权衡，而非盲目调大：

• 用 access log 记录 $request_length 或借助 nginx-module-vts 统计实际 body 大小分布，取 P95 或 P99 值作为基准
• 例如：95% 的上传请求 ≤ 4MB，则可设 client_body_buffer_size 4m
• 若单 worker 并发处理 100 个上传请求，每个占 4MB，则仅此一项就消耗 400MB 内存——需确认系统是否可承受
• 建议上限参考：单 worker 可用内存 × 70% ÷ 预估最大并发上传数

配合其他指令协同规避 IO

单独调大 buffer 不足以彻底避免磁盘落盘，必须搭配以下设置：

• client_max_body_size 必须 ≥ client_body_buffer_size，否则超限请求直接 413，buffer 设置无效
• client_body_in_file_only off（默认），确保只在 buffer 不足时才落盘；若设为 on，则所有 body 强制写文件，完全失去调优意义
• client_body_temp_path /path/to/temp 1 2 应指向内存盘（如 tmpfs）或低延迟 SSD，降低落盘成本（即使小概率触发）
• 启用 sendfile off 和 tcp_nopush off 对 body 接收无影响，无需调整

验证是否生效的实操方法

不能只看配置是否加载成功，要观察运行时行为：

• 开启 debug 日志：error_log /var/log/nginx/debug.log debug;，搜索 http client request body 相关行，确认是否出现 write to file 或 in memory
• 监控临时目录文件增长：watch -n 1 'ls -l /var/cache/nginx/client_temp/ | wc -l'，稳定为 0 表示基本未落盘
• 用 pidstat -r -p $(pgrep nginx) 1 观察 worker 进程 RSS 是否随上传并发线性上升，验证内存分配符合预期