根本原因是响应数据超出内存缓冲能力,Nginx被迫刷入磁盘;解决方向是让数据留内存流转或绕过缓存:对大文件下载等场景关proxy_buffering off实现流式转发,必须缓存时则按P95响应大小精准调大proxy_buffers并设proxy_busy_buffers_size为总量1/2~2/3,同时优化proxy_temp_path至SSD、proxy_temp_file_write_size至128k~256k,并配套延长超时与权限校验。

临时文件写入过多,根本原因是响应数据超出了内存缓冲能力,Nginx 被迫把溢出部分刷到磁盘。解决方向不是“清理文件”,而是让数据尽量留在内存里流转,或从源头绕过缓存。
先确认是不是真需要 proxy_buffering
对大文件下载、日志导出、SSE 流、视频回源等场景,关闭缓冲最有效:
- 在对应 location 中加 proxy_buffering off;,Nginx 边收边发,不攒整块响应
- 此时 proxy_buffers、proxy_busy_buffers_size、proxy_temp_file_write_size 全部失效,零落盘
- 仅 proxy_buffer_size 仍生效(管响应头),设为 4k–32k 即可
必须开启 buffering 时,精准扩大内存缓冲
重点不是堆参数,而是匹配业务响应体大小分布:
- 查 error.log 是否有 upstream response is buffered to a temporary file,再统计 P95 响应体大小(如用 access_log + $body_bytes_sent)
- 普通 HTML/API(平均 100KB):设 proxy_buffers 16 256k;(总 4MB)
- 报表导出/图片服务(常达 5–20MB):设 proxy_buffers 32 512k;(总 16MB),并同步调高 proxy_busy_buffers_size 8m;
- proxy_busy_buffers_size 必须 ≤ proxy_buffers 总量,且 ≥ 单块大小,否则启动失败或后端阻塞
控制落盘行为,减少 I/O 冲击
即使调大内存,突发大响应仍可能落盘。这时要优化写入方式和路径:
- 设 proxy_temp_file_write_size 128k; 或 256k;,降低 write() 系统调用频次(默认 32k 太小)
- 把 proxy_temp_path /mnt/ssd/nginx/proxy_temp 1 2; 指向独立 SSD 分区,避免与系统盘、日志盘争抢
- 设 proxy_max_temp_file_size 1g;,防止单个响应被切成几十个小文件,引发元数据风暴
- 若内存充足且能接受超限失败,直接 proxy_max_temp_file_size 0;,强制返回 502 暴露瓶颈
配套必须做的三件事
单调 buffer 参数效果有限,需协同收敛:
- 延长超时:proxy_read_timeout 300;(防后端慢)、proxy_send_timeout 120;(防弱网客户端接收慢)
- 确保 proxy_temp_path 目录存在、权限正确(nginx 用户可写)、挂载时带 noatime 参数
- 用 strace -e trace=write -p $(pgrep nginx | head -1) 验证实际 write 大小是否接近设定值,别只看配置


















