代理写入临时文件过多本质是响应数据反复溢出内存缓冲被迫刷盘，需从error.log日志线索出发，分层验证proxy_buffers等配置、proxy_temp_path路径、proxy_temp_file_write_size等行为三类关键点。
代理写入临时文件过多，本质是响应数据反复溢出内存缓冲、被迫刷盘，不是磁盘空间不足的表象问题，而是缓冲策略与业务特征错配。排查要从日志线索出发，分层验证配置、路径、行为三类关键点。
看 error.log 定位具体溢出类型
先查 Nginx 错误日志，不同提示对应不同根因：
-
“upstream sent too big header”：响应头过大（如 JWT、大量 Cookie），需调大
proxy_buffer_size，常见设为 32k–64k；注意它不能超过单块proxy_buffers大小 -
“an upstream response is buffered to a temporary file”：响应体超出内存缓冲，重点检查
proxy_buffers总容量是否低于 P95 响应大小；例如导出接口平均响应 8MB，却只配了8 128k（共 1MB），必然高频落盘 - 无明确提示但
proxy_temp_path下文件数量暴增：可能是小响应被高频切片写入（如大量 200KB 响应被切成多个 8k 文件），说明proxy_temp_file_write_size过小或路径在机械盘
核对 proxy_buffers 与 busy 区配置是否匹配
这两个参数必须协同生效，单独调大一个可能无效甚至报错：
-
proxy_buffers决定总内存缓冲量，例如16 256k表示共 4MB；应按业务实际响应体 P95 值上浮 20% 设置 -
proxy_busy_buffers_size必须 ≤proxy_buffers总大小，且建议设为总和的 1/2～2/3（如 2m～3m）；设得过大，Nginx 启动会失败 - 确认
proxy_buffering是on状态——若为off，则所有proxy_buffers类参数失效，此时写临时文件属于异常行为
检查临时路径与落盘控制是否合理
即使缓冲调大，路径和落盘策略不合理，仍会引发 I/O 拥塞或 inode 耗尽：
-
proxy_temp_path是否指向独立 SSD 或内存盘（如/dev/shm/nginx_temp）？严禁与系统盘、日志盘共用 -
proxy_max_temp_file_size是否按响应分布设为“防抖阈值”？API 接口建议 2m～4m，报表导出可设 10m～50m；设为 0 可禁用落盘，但会以 502 为代价 -
proxy_temp_file_write_size是否足够大？默认 8k～16k 易导致高频小 IO，建议调至 128k～256k，减少 write() 调用次数
验证超时与连接行为是否兜底到位
缓冲再大，卡在超时或连接中断上也会触发异常落盘或残留文件：
- 大响应接口是否延长了
proxy_read_timeout（防后端慢）和proxy_send_timeout（防弱网客户端接收慢）？建议分别设为 300 和 120 - 是否启用
proxy_http_version 1.1并清除 Connection 头？避免短连接反复握手加重缓冲压力 - 上传类接口是否配置了
client_body_timeout和client_max_body_size？防止慢速上传长期占用缓冲区并生成残留临时文件
