如何解决“504 Gateway Time-out”错误

我们在访问大流量网站或者运营有较多数据的网站时候，偶尔会出现504 Gateway Time-out错误，这多是网站服务器配置不当导致的，下面分享一下504GatewayTime-out错误的解决方法。

01

代码释义

504 Gateway Time-out就是字面意思，可以理解为网页请求超时，也就是浏览网站网页所发出的请求没有反应或者未响应，在网站程序层面来说，就是请求未能够执行相应的PHP-CGI程序，或者PHP-CGI程序未能做出相应的处理，又或者是CGI程序的响应处理结果未能够反馈到浏览器或者未能及时反馈到浏览器。

02

报错背景

504 Gateway Time-out错误多是存在于Nginx网站服务器环境下，多与nginx.conf与php-fpm.conf设置是否正确合理有关。解决方法就是根据网站服务器性能及网站流量等诸多因素整合考虑，正确合理的设置niginx.conf和php-fpm.conf配置。

03

解决方法

进行正确合理nginx.conf配置，我们需要首先了解和清楚我们网站服务器的配置性能，包括CPU、内存等，并对网站服务器进行必要的性能测试（可参考：vps主机性能测试方法详解），从而准确的掌握网站服务器自身性能状况；

04

其次，是通过网站统计代码的添加，分析一段时间内网站流量状况，比如：CNZZ站长统计等，掌握网站日流量及PHP-CGI请求的大概情况；

05

最后，根据我们掌握的服务器性能状况及网络流量情况，合理的对nginx.conf中的下列字句进行合理正确的设置。　

fastcgi_connect_timeout300s

fastcgi_send_timeout300s

fastcgi_read_timeout300s　

fastcgi_buffer_size128k

fastcgi_buffers8128k#8128　

fastcgi_busy_buffers_size256k

fastcgi_temp_file_write_size256k

fastcgi_intercept_errorson

06

还有就是php-fpm.conf中max_children与request_terminate_timeout两个重要参数的设置。这两个参数的设置需要我们根据PHP程序情况及服务器带宽状况综合考虑并计算出合理准确的值，才能够避免504 Gateway Time-out或者其他CGI无响应错误的出现。

第一种原因：目前lnmp一键安装包比较多的问题就是502 Bad Gateway，大部分情况下原因是在安装php前，脚本中某些lib包可能没有安装上，造成php没有编译安装成功。解决办法：可以尝试根据lnmp一键安装包中的脚本手动安装一下，看看是什么错误导致的。

第二种原因：在php.ini里，eaccelerator配置项一定要放在Zend Optimizer配置之前，否则也可能引起502 Bad Gateway

第三种原因：在安装好使用过程中出现502问题，一般是因为默认php-cgi进程是5个，可能因为phpcgi进程不够用而造成502，需要修改/usr/local/php/etc/php-fpm.conf 将其中的max_children值适当增加。

第四种原因：php执行超时，修改/usr/local/php/etc/php.ini 将max_execution_time 改为300。

第五种原因：磁盘空间不足，如mysql日志占用大量空间。

第六种原因：查看php-cgi进程是否在运行。

另外的解决办法：

Nginx 502 Bad Gateway的含义是请求的PHP-CGI已经执行，但是由于某种原因（一般是读取资源的问题）没有执行完毕而导致PHP-CGI进程终止，一般来说Nginx 502 Bad Gateway和php-fpm.conf的设置有关。

php-fpm.conf有两个至关重要的参数，一个是max_children，另一个是request_terminate_timeout，但是这个值不是通用的，而是需要自己计算的。

在安装好使用过程中出现502问题，一般是因为默认php-cgi进程是5个，可能因为phpcgi进程不够用而造成502，需要修改/usr/local/php/etc/php-fpm.conf 将其中的max_children值适当增加。

计算的方式如下：如果服务器性能足够好，且宽带资源足够充足，PHP脚本没有系循环或BUG的话可以直接将 request_terminate_timeout设置成0s。0s的含义是让PHP-CGI一直执行下去而没有时间限制。如果做不到这一点，也就 是说PHP-CGI可能出现某个BUG，或者宽带不够充足或者其他的原因导致PHP-CGI假死那么就建议给 request_terminate_timeout赋一个值，这个值可以根据服务器的性能进行设定。一般来说性能越好可以设置越高，20分钟-30分 钟都可以。

而max_children这个值又是怎么计算出来的呢？这个值原则上是越大越好，php-cgi的进程多了就会处理的很快，排队的请求就会很少。 设置max_children也需要根据服务器的性能进行设定，一般来说一台服务器正常情况下每一个php-cgi所耗费的内存在20M左右。

按照官方的答案，排查了相关的可能，并结合了网友的答案，得出了下面的解决办法：

1、查看php fastcgi的进程数（max_children值）代码：netstat -anpo | grep “php-cgi” | wc -l

5（假如显示5）

2、查看当前进程，代码：top观察fastcgi进程数,假如使用的进程数等于或高于5个，说明需要增加（根据机器实际状况而定）

3、调整/usr/local/php/etc/php-fpm.conf 的相关设置

<value name=”max_children”>10</value>

<value name=”request_terminate_timeout”>60s</value>

max_children最多10个进程，按照每个进程20MB内存，最多200MB。

request_terminate_timeout执行的时间为60秒，也就是1分钟。

---