proxy_max_temp_file_size 限制Nginx代理时单个临时磁盘文件的最大大小，超限则拒绝请求而非拆分写入；它不控制proxy_cache缓存空间、临时目录总用量或多个文件总大小。
proxy_max_temp_file_size 是 Nginx 代理模块中控制临时文件大小上限的关键参数，直接影响高并发、大请求体（如文件上传、长连接 POST）场景下的磁盘 I/O 行为。它不决定是否使用临时文件，而是限制单个临时文件的最大尺寸；一旦超过该值，Nginx 会拒绝请求（返回 500 或 413），而非拆分或轮转写入。因此，调优重点不是“越大越好”，而是匹配业务负载特征与后端处理能力。
理解触发临时文件的典型场景
当客户端请求体（client_body_temp_path 所指目录）超出内存缓冲区（由 client_body_buffer_size 控制）时，Nginx 会将剩余部分写入磁盘临时文件。常见高负载写入场景包括：
- 大文件上传（如 >1MB 的图片/视频/API 附件）
- 含大量表单字段的 POST 请求（如 CMS 后台批量导入）
- 上游服务响应体过大且启用了 proxy_buffering on（此时也受 proxy_max_temp_file_size 影响）
合理设置 proxy_max_temp_file_size 的依据
该值应基于三项实际约束综合判断：
- 磁盘空间余量：临时文件目录所在分区需预留至少 2–3 倍于该值的空闲空间（因多个并发请求可能同时生成临时文件）
- 单次请求最大合法载荷：例如业务明确限制上传文件 ≤50MB，则可设为 50m；若无硬限制，建议不超过 10m 并配合后端校验
- 内核与文件系统性能：XFS/ext4 对单文件写入效率较高，但若使用机械盘或低配云盘，过大的临时文件会加剧 seek 延迟；SSD 上可适度放宽至 20m–50m
配套必须调整的关联参数
单独调大 proxy_max_temp_file_size 不解决问题，需同步优化缓冲策略：
- client_body_buffer_size：设为 64k–128k（默认 8k），减少小请求落盘频率
- client_max_body_size：必须 ≥ proxy_max_temp_file_size，否则请求在进入代理逻辑前就被拦截
- client_body_temp_path：指定 SSD 分区上的专用路径（如 /ssd/nginx/client_temp），避免与系统日志共用磁盘
- proxy_buffering 和 proxy_buffers：若代理后端响应较大，也需检查 proxy_max_temp_file_size 是否影响响应缓存落盘（注意：此参数对响应体生效的前提是 proxy_buffering on 且响应超出 buffer 总和）
验证与监控建议
上线后需观察两项关键指标：
- Nginx error log 中是否出现 "client intended to send too large body"（说明 client_max_body_size 或 proxy_max_temp_file_size 过小）
- iostat -x 1 查看临时目录所在设备的 %util 和 await：若 %util 持续 >80% 或 await >20ms，说明磁盘成为瓶颈，需检查是否临时文件写入过于频繁或单文件过大
- 用 lsof -p $(pgrep nginx) | grep temp 抽样确认临时文件数量与生命周期，避免长连接导致文件堆积
