代理缓存区溢出时自动写入临时文件，由proxy_buffering开启、缓冲区填满及proxy_temp_path就绪共同触发，无需location块额外配置；关键在于http块中正确设置proxy_temp_path，并合理配置proxy_buffer_size和proxy_buffers。
代理缓存区溢出时自动写入临时文件，不是通过 location 块直接控制的，而是由 Nginx 缓冲机制与临时路径配置协同决定的。关键点在于：proxy_buffering 开启 + 缓冲区填满 + 临时路径就绪，系统会自然触发落盘行为，无需在 location 中额外“开启溢出写入”开关。
理解 proxy_buffering 和缓冲区溢出逻辑
Nginx 默认启用 proxy_buffering on，它会把后端响应先暂存在内存缓冲区（由 proxy_buffer_size 和 proxy_buffers 控制），再逐步传给客户端。当响应体超过内存缓冲总容量，且 proxy_buffering 为 on 时，Nginx 就会自动将超出部分写入磁盘临时文件——前提是已正确配置了对应的 *_temp_path。
-
proxy_buffer_size：单独存放响应头的缓冲区（默认 4k 或 8k） -
proxy_buffers：用于响应体的缓冲区数量和大小，例如proxy_buffers 8 16k表示最多用 8×16k = 128k 内存存响应体 - 一旦响应体 >
proxy_buffer_size + proxy_buffers总和，且proxy_buffering on，就会启用proxy_temp_path落盘
必须在 http 块中配置 proxy_temp_path
proxy_temp_path 只能在 http{} 或 server{} 块中声明，location 不支持该指令。它定义的是代理响应溢出时的落盘位置，而非缓存路径（注意区分 proxy_cache_path）。
- 推荐使用两级子目录结构，避免单目录文件过多：例如
proxy_temp_path /data/nginx/proxy_temp 1 2; - 不要与
client_body_temp_path共用同一磁盘分区，防止 I/O 争抢 - 建议放在 SSD 或低延迟存储上，提升落盘性能
- 临时文件在响应结束后自动清理；异常中断可能导致残留，需定期巡检
location 中只需确保缓冲策略生效
在 location 块里，你不需要也不应该写“开启溢出写入”这类指令。只需确认以下配置已就位：
-
proxy_buffering on;（默认即开启，显式写出更清晰） -
proxy_buffer_size和proxy_buffers设置合理（如proxy_buffer_size 4k; proxy_buffers 8 16k;） - 后端返回的响应确实可能较大（如文件下载、大 JSON）
- 全局
proxy_temp_path已正确定义且路径可写
验证是否真的发生了临时写入
可通过以下方式确认溢出落盘是否触发：
- 检查
proxy_temp_path目录下是否有新增的随机命名文件（如0000000001） - 开启 Nginx 错误日志
error_log /var/log/nginx/error.log info;，查找含upstream sent too big header或writev() failed (28: No space left on device)等提示（后者常因 temp_path 所在磁盘满导致） - 用
strace -p $(pgrep nginx) -e trace=write,openat观察 worker 进程是否调用 write 到 temp 目录
