Nginx 502和504错误原因分析

kjut

一直以来当nginx出现502或者504错误时，大多数的运维人员都会参考张宴大师的nginx优化文档来解决。但是什么情况下出现502，什么情况下出现504，确不是很清楚，反正就知道是php-cgi处理不过来了。前段时间curl模拟超时，偶然发现有时是502和504，刚好今天刚好有空测试。

在 php.ini 中有一个参数 max_execution_time 可以设置 PHP 脚本的最大执行时间，但是nginx+php-cgi(php-fpm) 中该参数不会起效。真正能够控制 PHP 脚本最大执行时：

<value name="request_terminate_timeout">0s</value>  

就是说如果是使用 apache+php-cgi 的模式运行 max_execution_time 是会生效的，max_execution_time

计算的只是PHP脚本本身执行的时间，执行之外的时间都不会计算在内。哪些属于执行之外的时间呢？包含sleep、数据交互、socket交互等等。

request_terminate_timeout的值如果设置为0或者过长的时间，就会有很多的进程卡住。我们知道php.ini 里面max_execution_time 可以设置 PHP 脚本的最大执行时间，但是nginx+php-cgi(php-fpm) 中该参数不会起效。

request_terminate_timeout默认值为 0 秒，也就是说，PHP 脚本会一直执行下去。这样，当所有的 php-cgi 进程都卡，这台 Nginx+PHP 已经无法再处理新的 PHP 请求了，Nginx 将给用户返回“502 Bad Gateway”。

Ngnix中的fastcgi 请求时间控制

fastcgi_connect_timeout

语法：fastcgi_connect_timeout time

默认值：fastcgi_connect_timeout 60

使用字段：http, server, location

指定同FastCGI服务器的连接超时时间。

fastcgi_read_timeout

语法：fastcgi_read_timeout time

默认值：fastcgi_read_timeout 60

使用字段：http, server, location

前端FastCGI服务器的响应超时时间，如果有一些直到它们运行完才有输出的长时间运行的FastCGI进程，或者在错误日志中出现前端服务器响应超时错误，可能需要调整这个值。

fastcgi_send_timeout

语法：fastcgi_send_timeout time

默认值：fastcgi_send_timeout 60

使用字段：http, server, location

指令为上游服务器设置等待一个FastCGI进程的传送数据时间，如果有一些直到它们运行完才有输出的长时间运行的FastCGI进程，那么可以修改这个值，如果你在上有服务器的error log里面发现一些超时错误，那么可以恰当的增加这个值。

指令指定请求服务器的超时时间，指完成了2次握手的连接，而不是完整的连接，如果在这期间客户端没有进行数据传递，那么服务器将关闭这个连接。

以下是具体的测试过程

我们首先写了一个简单php页面

<?php
echo "start";
sleep(61);
echo "end";
?>
1.设置php执行超时时间为60s

<value name="request_terminate_timeout">60s</value>
结果返回502 Bad Gateway
设置 <value name="request_terminate_timeout">59s</value>
就能正常响应
2.设置 <value name="request_terminate_timeout">0s</value>，然php可以一直执行
然后再设置（我们这里是sleep，所以真正影响的是 fastcgi_read_timeout参数）

fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 60;
结果返回504 Gateway Time-out。
修改为：

fastcgi_connect_timeout 300;

fastcgi_send_timeout 300;

fastcgi_read_timeout 300;

则正常响应。

综上所述，502错误是request_terminate_timeout参数决定，504错误是

fastcgi_connect_timeout、fastcgi_send_timeout、fastcgi_read_timeout 参数决定。既然知道原理，那解决nginx 502和504错误就很简单了，相信聪明的大家都知道怎么解决。