要让大体积POST表单全程内存处理，需按真实请求分布设client_body_buffer_size（如P95=320KB→设512k），并同步配置client_max_body_size、client_body_temp_path和client_body_timeout，避免落盘与内存耗尽。
要让大体积 POST 表单全程在内存中处理，关键不是把 client_body_buffer_size 设得越大越好，而是让它精准覆盖业务中绝大多数请求体大小，并避开 Nginx 内部 25% 安全余量机制导致的“卡边落盘”。设对了，请求体不写磁盘；设错了，哪怕只超 1KB，也会触发临时文件写入，增加延迟、消耗 I/O，还可能使缓存失效。
按真实上传分布设值，别信“默认”或“经验”
先从 access log 或前端埋点提取 Content-Length，统计 P95（95% 请求 ≤ X）和 P99 值。Nginx 实际分配缓冲区时会自动加约 25% 余量（size += size >> 2），所以不能简单按最大值设：
- 若 P95 是 320KB → 推荐设
512k或1m，跳过临界区 - 若 P95 是 4.8MB（如静态包上传）→ 设
6m（4.8 × 1.25），比设5m更稳妥 - 纯 JSON 表单（含 JWT、小字段）：
64k–128k足够 - 头像/Base64 表单（通常 ≤500KB）：建议
256k–512k
必须同步配齐三项配套配置
只改 client_body_buffer_size 几乎无效，以下三者必须同级声明、逻辑自洽：
-
client_max_body_size≥ 缓冲区值，且作用域一致（推荐放在location块内）。否则合法大请求还没进缓冲区就被 413 拦截 -
client_body_temp_path必须指向可写、有空间、低延迟路径（如/dev/shm/nginx-body 1 2）。即使 buffer 设得再大，超限仍要落盘，路径不可用则请求直接失败 -
client_body_timeout建议设10–60s（常用30s），防慢速上传长期霸占缓冲区，拖垮整个 worker
验证是否真走内存，不靠猜测靠日志
配置 reload 成功 ≠ 生效。需观测运行态行为：
- 开启 debug 日志：
error_log /var/log/nginx/debug.log debug; - 搜索
"http client request body buffered"—— 出现即表示走内存；若看到"temp file"或"client request body is buffered to a temporary file"，说明已落盘 - 压测对比：用
wrk模拟典型表单提交，观察平均延迟是否下降、磁盘write/s是否明显减少
注意作用域限制与并发内存压力
client_body_buffer_size 是 per-request 分配的，不是共享池。设得过大，在高并发下极易耗尽内存：
- 设为
4m，单 worker 并发处理 500 个表单 → 仅此一项就占用约 2GB RAM - 建议上限参考：单 Worker 可用内存 × 70% ÷ 预估最大并发提交数
- 该参数不支持在
server块中设置，只能放在http或location中。需通过location精准控制上传接口（如location /api/submit { ... }）
