优化核心是让client_body_buffer_size精准覆盖p95/p99真实请求体大小并避开25%自动余量临界点，同步配置client_max_body_size≥该值、client_body_temp_path可写低延迟、client_body_timeout 10–30秒，并通过debug日志验证“buffered”行为。
默认值是 8KB，它只适合纯文本表单或极小 JSON 请求。直接沿用这个值处理带图片、文件上传的业务，大概率会触发磁盘临时写入，拖慢上传、增加 I/O 压力。优化不是堆大数值，而是让缓冲区精准覆盖你真实上传的 P95～P99 尺寸，并避开 Nginx 内部 25% 自动扩容机制带来的“卡边”落盘。
看真实数据，别信“最大”或“平均”
统计最近一周 access log 或前端上报的 Content-Length，重点取 P95（95% 请求 ≤ X）和 P99 值：
- 纯 API（含 JWT、小字段）：P95 ≈ 16KB → 设 32k 或 64k 更稳
- 头像/截图类（≤500KB）：P95 ≈ 320KB → 别设 320k，按 ×1.25 ≈ 400k，直接选 512k
- 文档/压缩包（≤20MB）：P95 ≈ 4.8MB → 推荐 6m，而非盲目设 8m 或 16m
必须同步配齐三项配套设置
单独改 client_body_buffer_size 几乎无效，三者需在同一个 location 块中声明：
-
client_max_body_size ≥ 缓冲区值：比如设了
client_body_buffer_size 512k，就得配client_max_body_size 512k或更大；否则请求还没读完就被 413 拦截 - client_body_temp_path 路径必须存在、Nginx worker 用户可写、磁盘空间充足且 I/O 延迟低——即使调优到位，突发超限仍要落盘，这个目录不能掉链子
- client_body_timeout 建议设为 10–30 秒：防弱网环境下慢速上传长期霸占内存缓冲区
验证是否真走内存，不是 reload 就算数
配置生效 ≠ 行为生效。必须观测运行态：
- 开启 debug 日志：
error_log /var/log/nginx/debug.log debug;，上传后搜索 http client request body buffered（走内存）或 temp file（落盘） - 观察
client_body_temp目录下新文件生成频率，明显减少说明缓冲区起效 - 用
top看 nginx worker 进程 RSS 内存波动，避免因缓冲过大导致持续攀升甚至 OOM
