Nginx 提示 504 Gateway Time-out(The gateway did not receive a timely response from the...)解决办法

本文介绍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的报错。