本文介绍nginx出现504 Gateway Time-out问题的原因,分析问题并提供解决方法。
1.问题分析
nginx访问出现504 Gateway Time-out,一般是由于程序执行时间过长导致响应超时,例如程序需要执行90秒,而nginx最大响应等待时间为30秒,这样就会出现超时。
通常有以下几种情况导致
1.程序在处理大量数据,导致等待超时。
2.程序中调用外部请求,而外部请求响应超时。
3.连接数据库失败而没有停止,死循环重新连。
出现这种情况,我们可以先优化程序,缩短执行时间。另一方面,可以调大nginx超时限制的参数,使程序可以正常执行。
对于访问超时的设定,nginx与php都有相关的设置,可以逐一进行修改。
2.解决方法
1) nginx配置
nginx.conf中,设置以下几个参数,增加超时时间
#修改Nginx配置:
fastcgi_connect_timeout 1200s;#原设置为300s
fastcgi_send_timeout 1200s;#原设置为300s
fastcgi_read_timeout 1200s;#原设置为300s
fastcgi_buffer_size 64k;
fastcgi_buffers 4 64k;
fastcgi_busy_buffers_size 128k;
fastcgi_temp_file_write_size 256k;
这里最主要的设置是前三条,即
fastcgi_connect_timeout # 同 FastCGI 服务器的连接超时时间,默认值60秒,它不能超过75秒;
fastcgi_send_timeout # Nginx 进程向 FastCGI 进程发送 request ,整个过程的超时时间,默认值60秒;
fastcgi_read_timeout # FastCGI 进程向 Nginx 进程发送 response ,整个过程的超时时间,默认值60秒;
2) php配置
php.ini
max_execution_time
php脚本最大执行时间
display_errors = on
memory_limit = 256M
php-fpm
request_terminate_timeout
设置单个请求的超时时间
php程序中可加入 set_time_limit(seconds)
例如 set_time_limit(0) 表示不超时。
3) 服务器的一些常规设置问题
情况一:由于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。
设置完重启服务器
参考:https://zhidao.baidu.com/question/713173162334090965.html
https://yq.aliyun.com/articles/274941
http://ask.hwsem.com/question/1605
4) 设置CDN的回源配置》回源请求超时时间
(2021.09.03 通过修改这个配置最终解决了 504 问题)
由于CDN回源取数据的时候,如果源站在30s内没有响应,CDN会提示504 Gateway Time-out的报错。