如何解决nginx 504 Gateway Time-out错误

Posted 2023-04-10

情况一：由于nginx默认的fastcgi进程响应缓冲区太小造成
这种情况下导致fastcgi进程被挂起，如果fastcgi服务队这个挂起处理不是很好的话，就可能提示“504 Gateway Time-out”错误。
情况一解决办法：
默认的fastcgi进程响应的缓冲区是8K，我们可以设置大一点，在nginx.conf里，加入：fastcgi_buffers 8 128k
这表示设置fastcgi缓冲区为8块128k大小的空间。
情况一解决办法（改进）：
在上述方法修改后，如果还是出现问题，我们可以继续修改nginx的超时参数，将参数调大一点，如设置为60秒：
send_timeout 60;
经过这两个参数的调整，结果没有再提示“504 Gateway Time-out”错误，说明效果还是挺不错的，问题基本解决。
情况二：php环境的配置问题
这里我们需要对php-fpm和nginx进行配置修改。因为这种情况下，也会出现“504 Gateway Time-out”错误提示。
情况二解决办法（ php-fpm配置修改）：
将max_children由之前的10改为30，这样操作是为了保证有充足的php-cgi进程可以被使用。
将request_terminate_timeout由之前的0秒改成60秒，这样使php-cgi进程处理脚本的超时时间提高到60秒，可以防止进程被挂起以提高利用效率。
6
情况二解决办法（nginx配置修改）：
为了减少fastcgi的请求次数，尽量维持buffers不变，我们要更改nginx的几个配置项，如下：
将fastcgi_buffers由4 64k改为2 256k;
将fastcgi_buffer_size 由64k改为128k;
将fastcgi_busy_buffers_size由128k改为256k;
将fastcgi_temp_file_write_size由128k改成256k。
7
情况二解决办法修改完，我们需要重新加载php-fpm和nginx的配置，然后再进行测试。之后就没有发现“504 Gateway Time-out”错误，效果也还是不错的！ 参考技术A 在安装完Nginx+PHP-fpm+mysql后，跑PHP的应用会经常出现504 Gateway Time-out 或者502 Bad Gateway的情况。

Nginx 504 Gateway Time-out 的含义是所请求的网关没有请求到，简单来说就是没有请求到可以执行的 PHP-CGI。这种情况可能是由于 nginx 默认的 fastcgi 进程响应的缓冲区太小造成的, 这将导致 fastcgi 进程被挂起, 如果你的 fastcgi 服务对这个挂起处理的不好, 那么最后就极有可能导致 504 Gateway Time-out。 参考技术B Nginx 502 Bad Gateway的含义是请求的PHP-CGI已经执行，但是由於某种原因(一般是读取资源的问题)没有执行完毕而导致PHP-CGI进程终止。　　　　Nginx 504 Gateway Time-out的含义是所请求的网关没有请求到，简单来说就是没有请求到可以执行的PHP-CGI。　　　　解决这两个问题其实是需要综合思考的，一般来说Nginx 502 Bad Gateway和php-fpm.conf的设置有关，而Nginx 504 Gateway Time-out则是与nginx.conf的设置有关。　　　　而正确的设置需要考虑服务器自身的性能和访客的数量等多重因素。 参考技术C 情况一：由于nginx默认的fastcgi进程响应缓冲区太小造成
这种情况下导致fastcgi进程被挂起，如果fastcgi服务队这个挂起处理不是很好的话，就可能提示“504 Gateway Time-out”错误。
情况一解决办法：
默认的fastcgi进程响应的缓冲区是8K，我们可以设置大一点，在nginx.conf里，加入：fastcgi_buffers 8 128k
这表示设置fastcgi缓冲区为8块128k大小的空间。
情况一解决办法（改进）：
在上述方法修改后，如果还是出现问题，我们可以继续修改nginx的超时参数，将参数调大一点，如设置为60秒：
send_timeout 60;
经过这两个参数的调整，结果没有再提示“504 Gateway Time-out”错误，说明效果还是挺不错的，问题基本解决。
情况二：PHP环境的配置问题
这里我们需要对php-fpm和nginx进行配置修改。因为这种情况下，也会出现“504 Gateway Time-out”错误提示。
情况二解决办法（ php-fpm配置修改）：
将max_children由之前的10改为30，这样操作是为了保证有充足的php-cgi进程可以被使用。
将request_terminate_timeout由之前的0秒改成60秒，这样使php-cgi进程处理脚本的超时时间提高到60秒，可以防止进程被挂起以提高利用效率。
情况二解决办法（nginx配置修改）：
为了减少fastcgi的请求次数，尽量维持buffers不变，我们要更改nginx的几个配置项，如下：
将fastcgi_buffers由4 64k改为2 256k;
将fastcgi_buffer_size 由64k改为128k;
将fastcgi_busy_buffers_size由128k改为256k;
将fastcgi_temp_file_write_size由128k改成256k。
7
情况二解决办法修改完，我们需要重新加载php-fpm和nginx的配置，然后再进行测试。之后就没有发现“504 Gateway Time-out”错误，效果也还是不错的！ 参考技术D 解决Nginx 504 Gateway Time-out这个问题的方法是修改nginx.conf配置，默认的fastcgi进程响应的缓冲区是8K, 我们可以设置大点即可。

nginx出现504 Gateway Time-out的解决思路

http://www.xbc.me/nginx-fix-504-gateway-timeout/

 

在安装完Nginx+PHP-fpm+Mysql后 （如何安装LNMP环境，请参考快速配置LNMP环境Nginx0.8.54+MYSQL5.5.16+PHP5.3.8+CentOS 6），跑PHP的应用会经常出现504 Gateway Time-out 或者502 Bad Gateway的情况。

这个问题耽误了我差不多4个小时的时间，网上有很多前辈们的解决方法，在这里记录下解决这个问题的思路。首先这个问题主要是因为PHP的Script执行时间太长了，已经超过nginx能接受的底线。

在nginx的日志中会看到这样的log

2012/08/11 13:39:45 [error] 30788#0: *1 upstream timed out (110: Connection timed out) 
while reading response header from upstream, client: 127.0.0.1, server: www.xbc.me, 
request: "GET / HTTP/1.1", upstream: "fastcgi://127.0.0.1:9000", host: "www.xbc.me"

在php-fpm的日志中会发现这样的log

2012/08/11 13:39:45 [error] 30788#0: *1 upstream timed out (110: Connection timed out) 
while reading response header from upstream, client: 127.0.0.1, server: www.xbc.me, 
request: "GET / HTTP/1.1", upstream: "fastcgi://127.0.0.1:9000", host: "www.xbc.me"

 

一般来说，出现这样的情况是因为Nginx会从php-fpm的9000端口读取fastcgi的执行结果，等来N久都不见回复，所以就报504了。解决办法很简单，修改php的最长执行时间

; Maximum execution time of each script, in seconds; http://php.net/max-execution-time; 
Note: This directive is hardcoded to 0 for the CLI SAPI;
fix by Matt 2012.8.11
;max_execution_time = 3000

在这里我注释掉php.ini参数的时间限制。还有php-fpm里的

;request_terminate_timeout = 0

 

这个参数会在php.ini中max_execution_time因为某些原因不能正常工作才会生效。

之前设置的是300s，安装Magento的时候就一直就报504。后来索性修改到3000了。在Nginx的配置文件添加

#add by Matt 2012.8.11
fastcgi_read_timeout 3000;
fastcgi_connect_timeout 3000;
fastcgi_send_timeout 3000;

Magento你到底安装多少sql文件啊？

PS:有时候缓存过小也会引起504，具体情况还需要根据Nginx的日志内容来分析。修改fastcgi的缓存大小：

fastcgi_buffers 2 256k;
fastcgi_buffer_size 128k;
fastcgi_busy_buffers_size 256k;
fastcgi_temp_file_write_size 256k;

参考

解决Nginx + PHP（FastCGI）遇到的502 Bad Gateway错误[原创]

安装 LNMP 的 VPS Nginx 出现 504 Gateway Time-out

nginx php fastcgi Connection reset by peer的原因及解决办法