要让 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 字节。
- 统计 access log 或前端埋点中的
Content-Length，取 P95 或 P99 值（不是平均值） - P95 = 320KB → 推荐设
512k或1m，跳过 384k–448k 这类易卡住的中间区间 - 纯 JSON 表单（含 JWT）：64k–128k 足够
- 头像/Base64 提交（≤500KB）：设
512k更稳妥 - 文档或压缩包直传（≤20MB）：可设
2m～4m，但必须同步评估并发压力
必须同步配齐三项配套配置
单独改 client_body_buffer_size 几乎无效。以下三者需在同一作用域（推荐 location 块内）声明，逻辑自洽：
-
client_max_body_size≥ 缓冲区值，否则合法大请求直接返回 413，根本进不了缓冲区 -
client_body_temp_path指向可写、低延迟路径（如/dev/shm/nginx-body 1 2），确保突发超限时能可靠落盘 -
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"→ 已落盘 - 配合
iostat -x 1观察client_body_temp_path所在磁盘的write/s是否明显下降
注意并发与内存的实际压力
该参数是 per-request 分配的，不是共享池。设为 4m，在单 worker 并发处理 500 个请求时，仅此项就占用约 2GB 内存。
- 建议上限参考公式：
单 Worker 可用内存 × 70% ÷ 预估最大并发提交数 - 高并发轻量提交（如埋点、心跳）反而建议调小到
4k～8k，节省内存给更多连接 - 该指令不支持在
server块中设置，只能放在http或location中
