Nginx反向代理下大文件上传超时返回504错误求助

看起来你遇到的是典型的反向代理场景下大文件上传超时问题，虽然已经调大了Nginx的全局超时参数和请求体大小限制，但核心问题可能不在Nginx本身，而是上游服务器或局部配置覆盖导致的。结合你提供的日志和配置，我帮你梳理下排查方向和解决办法：

一、先定位问题根源：超时来自上游服务器 #

从错误日志可以明确看到：

2024/01/31 11:25:39 [error] 312417#312417: *510967 upstream timed out (110: Connection timed out) while sending request to upstream...

这说明Nginx已经把请求转发给了上游服务器10.0.0.177:80，但上游服务器处理大文件上传的时间超过了Nginx的等待超时，或者上游本身在处理大文件时出现了卡顿/超时。

二、具体排查与解决步骤 #

1. 检查上游服务器的超时配置

Nginx的proxy_read_timeout是等待上游返回响应的最大时间，但如果上游服务器自身的请求处理超时设置过小，会先于Nginx中断请求，导致Nginx触发504。你需要根据上游服务的类型调整对应配置：

• 如果是Python服务（比如Flask/Django）：检查WSGI服务器（如gunicorn）的timeout参数，默认一般是30秒，大文件上传需要调大到300秒以上；同时确认框架本身的上传超时设置。
• 如果是PHP-FPM：调整php-fpm.conf里的request_terminate_timeout和request_slowlog_timeout，避免PHP进程提前终止大文件上传请求。
• 如果是Java Tomcat：修改server.xml里Connector的connectionTimeout、keepAliveTimeout，同时调整maxSwallowSize（控制允许接收的请求体大小，避免因大文件被Tomcat中断）。
• 如果是Node.js服务：设置server.timeout为足够大的值（比如300000毫秒=5分钟），同时确认使用的框架（如Express）有没有单独的超时中间件。

2. 确保Nginx的超时配置在对应Location生效

你当前的超时配置是全局的，但如果处理/up/请求的location块里有单独的超时设置，会覆盖全局配置。建议在对应的location中明确指定超时参数：

location /up/ {
    proxy_pass http://10.0.0.177:80/up/;
    # 明确设置超时，覆盖可能的局部配置
    proxy_connect_timeout 300s;
    proxy_send_timeout 300s;
    proxy_read_timeout 300s;
    # 保留你原有的proxy_set_header等配置
    proxy_set_header X-Forwarded-Scheme $scheme;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

3. 检查Nginx临时目录的状态

大文件上传时，Nginx会先将请求体写入client_body_temp_path指定的临时目录（你这里是/tmp/nginx/body），如果该目录：

• 磁盘空间不足
• 权限不足（Nginx进程没有读写权限）
• inode耗尽

都可能导致上传过程中卡住，最终触发超时。可以用以下命令检查：

# 检查磁盘空间
df -h /tmp/
# 检查目录权限
ls -ld /tmp/nginx/body

4. 考虑启用分块上传（可选）

如果后端服务支持，建议让客户端（比如你用的ShareX）启用分块上传功能，将大文件拆分成多个小文件块依次上传。这样每个请求的处理时间都在超时范围内，从根本上避免单次请求超时的问题。

三、验证方法 #

调整完配置后，先重启Nginx和上游服务，然后尝试上传大文件，观察日志：

• 如果访问日志返回200，说明问题解决；
• 如果还是504，再检查上游服务的日志，看是否有内部错误或超时记录，进一步定位上游的问题。

备注：内容来源于stack exchange，提问作者user3930869