proxy_max_temp_file_size 是单个临时文件尺寸上限，仅在 proxy_buffering on、有 Content-Length、响应超内存缓冲且需落盘时生效；应据业务响应大小设值，并同步调优 proxy_buffer_size、proxy_buffers、proxy_busy_buffers_size 及 proxy_temp_path 路径。
proxy_max_temp_file_size 不是“磁盘缓存大小”，而是单个临时文件的尺寸上限，它只在特定缓冲溢出路径中起作用。处理好它，关键不是孤立调这个值，而是理清它和内存缓冲、落盘时机、存储路径之间的配合逻辑。
它什么时候真正生效
这个参数只在以下四个条件同时满足时才参与决策：
-
proxy_buffering on;（默认开启，必须保持） - 后端响应有完整
Content-Length或非 chunked 编码 - 响应体大小超过
proxy_buffer_size + proxy_buffers总内存容量 - Nginx 决定把溢出部分写入磁盘（而非直接流式转发）
此时，Nginx 会把超出部分分块写入 proxy_temp_path 下的临时文件，而每个文件不能超过 proxy_max_temp_file_size 指定的大小。
如何合理设值：看业务响应分布
不要凭感觉填 1g 或 0，要结合真实数据：
- API 接口（JSON/HTML）平均 2m～
5m，兼顾内存与容错 - 报表导出、批量查询多在 2–20MB → 设
20m～50m，避免拆成十几个小文件刷盘 - 视频分片、大附件下载常达 50–200MB → 设
100m～512m，但务必确保proxy_temp_path挂在 SSD 且空闲空间 ≥ 3 倍该值
必须同步调整的三项缓冲配置
单改 proxy_max_temp_file_size 几乎无效，要一起配：
-
proxy_buffer_size 16k;：专存响应头，够用即可，过大反而易截断长 header -
proxy_buffers 8 128k;：总内存缓冲约 1MB，覆盖主流响应；若常处理 >1MB 数据，可升为16 256k -
proxy_busy_buffers_size 256k;：设为单块 buffer 的 2 倍左右，保障转发不卡住接收
磁盘路径与 IO 优化不能少
光调参数不换路径，等于在拥堵路口限速却不修路：
- 把
proxy_temp_path /ssd/nginx/proxy_temp 1 2;显式指向 NVMe 分区，避开系统盘 - 若追求极致低延迟且内存充足，可用
proxy_temp_path /dev/shm/nginx_temp 1 2;（需提前挂载足够大小 tmpfs） - 配合
proxy_temp_file_write_size 256k;，减少 write() 系统调用频次，降低随机 IO
特殊策略：设为 0 的真实含义
proxy_max_temp_file_size 0; 表示：一旦响应超出内存缓冲，Nginx 不写任何临时文件，也不拆分，而是直接返回 502 或切换为流式转发（取决于其他配置）。
但它要求：
-
proxy_buffering on;保持开启 -
proxy_buffers总量能兜住典型响应，否则 502 概率陡增 - 不适用于不可控的大响应场景（如用户上传后端再吐出原始文件）
不复杂但容易忽略
