在 linux 中优化 nginx 代理大文件传输超时，核心是调整 proxy_read_timeout、proxy_send_timeout 和 proxy_connect_timeout 参数。将这三个值设置为大于后端处理或传输所需的时间（例如 3600 秒），即可解决因默认 60 秒超时导致的连接中断。
如何配置 proxy_read_timeout 以支持长耗时请求
直接修改 proxy_read_timeout 为较大的数值，如 3600，可确保 Nginx 等待后端响应的时间足够长。该参数控制的是 Nginx 与后端服务器之间的读取超时，即从后端收到第一个字节开始计时，直到收到完整响应为止。
server {
listen 80;
server_name example.com;
location /api/upload {
proxy_pass http://backend_server;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_connect_timeout 10s;
}
}
上述配置中，proxy_read_timeout 设为 3600 秒，意味着 Nginx 会等待后端最多一小时来发送数据。如果后端在处理大文件上传时耗时较长，这个设置能防止 Nginx 提前关闭连接。同时，proxy_send_timeout 也设为相同值，用于控制 Nginx 向后端发送请求的超时时间。这两个参数共同作用，确保整个传输过程不会因为中间的网络停顿或后端处理延迟而中断。
为什么还需要调整 proxy_send_timeout 和 proxy_connect_timeout
除了读取超时，proxy_send_timeout 和 proxy_connect_timeout 同样影响大文件传输的稳定性。proxy_send_timeout 控制 Nginx 向客户端或后端发送数据的超时时间，若设置为默认值 60 秒，可能在上传大文件时因网络波动导致中断。proxy_connect_timeout 则控制建立连接的超时时间，通常保持较短值如 10 秒即可，因为连接建立本身不应耗时过长。
# 验证配置是否生效 nginx -t # 重载配置 systemctl reload nginx
通过 nginx -t 检查配置语法是否正确，然后使用 systemctl reload nginx 重载配置使更改生效。在实际测试中，可以使用 curl 命令模拟大文件上传，观察是否还会出现超时错误。例如：curl -X POST -F "file=@large_file.zip" http://example.com/api/upload。如果传输成功且无中断，说明超时参数已正确优化。
当后端服务返回空响应时 Nginx 如何处理
如果后端服务在处理大文件时未能及时返回任何数据，Nginx 会根据 proxy_read_timeout 的值决定是否断开连接。若后端完全无响应，Nginx 会在超时后返回 504 Gateway Timeout 错误。为避免这种情况，应确保后端服务在接收到请求后尽快开始发送数据，即使只是部分数据。此外，可以结合 proxy_buffering off; 禁用缓冲，使 Nginx 直接将后端响应流式传输给客户端，减少内存占用并提高实时性。
