大文件上传超时需协同调优Nginx四大参数：client_max_body_size、client_body_timeout、proxy_read_timeout、proxy_send_timeout，并在location块中配置；同时关闭缓冲、指定临时路径，并同步调整后端与客户端超时设置。
大文件上传时提示超时，不是 proxy_pass 本身的问题，而是 Nginx 在多个环节设置了默认偏短的等待时限。关键要分清“谁在等谁”，再逐项调优。
必须同步调整的四大核心参数
只改 proxy_read_timeout 是常见误区。上传大文件涉及完整请求生命周期，以下四项需协同设置：
-
client_max_body_size：设为大于目标文件（如
100m），否则 Nginx 直接返回 413，根本不会走到 proxy_pass - client_body_timeout：控制客户端两次发送数据包的间隔（非总耗时），弱网或断点续传场景建议 ≥300s
-
proxy_read_timeout：后端处理完并开始返回响应后的等待上限，应略高于后端实际耗时（如导出接口需 5 分钟，这里设
320s） -
proxy_send_timeout：Nginx 向后端发送整个请求体（含文件）期间，两次写操作的最大空闲时间，大文件建议设为
300s
上传路径要单独配 location
全局 http 块里设的 timeout 不一定生效——Nginx 超时参数作用域优先级是 location > server > http。上传接口通常有固定前缀（如 /upload/ 或 /api/v1/files），应在对应 location 块中显式配置：
location /upload/ {<br> client_max_body_size 500m;<br> client_body_timeout 600;<br> proxy_read_timeout 1200;<br> proxy_send_timeout 600;<br> proxy_pass http://backend;<br>}
缓冲与临时文件不能忽略
大文件上传会触发 Nginx 缓冲行为，若不干预易内存溢出或卡死：
- 加
proxy_buffering off;关闭响应缓冲（适用于后端流式返回） - 加
proxy_request_buffering off;（Nginx ≥1.7.11）允许请求体流式转发，避免等完整 body 再发 - 指定临时存储路径：
client_body_temp_path /var/tmp/nginx/client_body 1 2;，确保该目录磁盘充足、权限可写
别忘了客户端和后端两端的配合
Nginx 只是中间一环，超时问题常因两端未对齐而反复出现：
- 若后端是 PHP-FPM，
proxy_read_timeout无效，必须用fastcgi_read_timeout，且 PHP 的max_execution_time和request_terminate_timeout也得同步加大 - 若后端是 Java（如 Spring Boot），注意其启动冷延迟，
proxy_connect_timeout得设到 90s 以上，否则连接阶段就 502 - 前端发起请求时，浏览器或 SDK 自身也有连接/读取超时设置，需一并检查是否比 Nginx 更短
