Nginx 如何在 Nginx 中配置 client_body_buffer_size 优化请求体内存读取性能

要让 POST/PUT 请求体全程走内存，关键在于精准设置 client_body_buffer_size 以匹配真实请求分布并避开 Nginx 25% 自动扩容导致的“卡边落盘”，同时必须同步配置 client_max_body_size、client_body_temp_path 和 client_body_timeout，并通过 debug 日志与 iostat 验证实际行为。

要让 POST/PUT 请求体全程走内存、减少磁盘 I/O、提升转发效率，关键不是堆大数值，而是让 client_body_buffer_size 精准匹配你的真实请求分布，并绕开 Nginx 内部 25% 自动扩容机制带来的“卡边落盘”问题。

按业务请求体大小设值，避开临界点

Nginx 实际分配缓冲区内存时会自动加约 25% 余量（size += size >> 2）。若你设 256k，而真实请求体达 255KB，计算后需约 319KB，仍会触发临时文件写入——哪怕只超 1 字节。

1. 统计 access log 或前端埋点中的 Content-Length，取 P95 或 P99 值（不是平均值）
2. P95 = 320KB → 推荐设 512k 或 1m，跳过 384k–448k 这类易卡住的中间区间
3. 纯 JSON 表单（含 JWT）：64k–128k 足够
4. 头像/Base64 提交（≤500KB）：设 512k 更稳妥
5. 文档或压缩包直传（≤20MB）：可设 2m～4m，但必须同步评估并发压力

必须同步配齐三项配套配置

单独改 client_body_buffer_size 几乎无效。以下三者需在同一作用域（推荐 location 块内）声明，逻辑自洽：

1. client_max_body_size ≥ 缓冲区值，否则合法大请求直接返回 413，根本进不了缓冲区
2. client_body_temp_path 指向可写、低延迟路径（如 /dev/shm/nginx-body 1 2），确保突发超限时能可靠落盘
3. client_body_timeout 设为 10–60s（常用 30s），防慢速上传长期霸占内存，拖垮 worker

验证是否真走内存，不靠 reload 靠日志

配置重载成功 ≠ 行为生效。必须观测运行态行为：

1. 开启 debug 日志：error_log /var/log/nginx/debug.log debug;
2. 压测或真实请求后，搜索日志关键词："http client request body buffered" → 表示走内存；"temp file" 或 "client request body is buffered to a temporary file" → 已落盘
3. 配合 iostat -x 1 观察 client_body_temp_path 所在磁盘的 write/s 是否明显下降

注意并发与内存的实际压力

该参数是 per-request 分配的，不是共享池。设为 4m，在单 worker 并发处理 500 个请求时，仅此项就占用约 2GB 内存。

1. 建议上限参考公式：单 Worker 可用内存 × 70% ÷ 预估最大并发提交数
2. 高并发轻量提交（如埋点、心跳）反而建议调小到 4k～8k，节省内存给更多连接
3. 该指令不支持在 server 块中设置，只能放在 http 或 location 中