nginx 502Bad Gateway錯誤解決辦法

一些運行在Nginx上的網站有時候會出現“502 Bad Gateway”錯誤，有些時候甚至頻繁的出現。以下是小編搜集整理的一些Nginx 502錯誤的排查方法，供參考：

Nginx 502錯誤的原因比較多，是因為在代理模式下后端服務器出現問題引起的。這些錯誤一般都不是nginx本身的問題，一定要從后端找原因！

Nginx 502的觸發條件

502錯誤最通常的出現情況就是后端主機當機。在upstream配置里有這么一項配置：proxy_next_upstream，這個配置指定了 nginx在從一個后端主機取數據遇到何種錯誤時會轉到下一個后端主機，里頭寫上的就是會出現502的所有情況，默認是 error timeout。error就是當機、斷線之類的，timeout就是讀取堵塞超時，比較容易理解。我一般是全寫上的：

proxy_next_upstream error timeout invalid_header http_500 http_503;不過現在可能要去掉http_500這一項了，http_500指定后端返回500錯誤時會轉一個主機，后端的jsp出錯的話，本來會打印一堆 stacktrace的錯誤信息，現在被502取代了。但公司的程序員可不這么認為，他們認定是nginx出現了錯誤，我實在沒空跟他們解釋502的原理 了……

是503錯誤就可以保留，因為后端通常是apache resin，如果apache死機就是 error，但 resin死機，僅僅是503，所以還是有必要保留的。

解決辦法

遇到502問題，可以優先考慮按照以下兩個步驟去解決。

1、查看當前的 PHP FastCGI進程數是否夠用：

代碼如下:

如果實際使用的“FastCGI進程數”接近預設的“FastCGI進程數”，那么，說明“FastCGI進程數”不夠用，需要增大。

2、部分PHP程序的執行時間超過了Nginx的等待時間，可以適當增加nginx.conf配置文件中FastCGI的timeout時間，例如：

代碼如下:

php.ini中memory_lim it設低了會出錯，修改了php.ini的memory_lim it為 64M，重啟 nginx，發現好了，原來是PHP的內存不足了。

如果這樣修改了還解決不了問題，可以參考下面這些方案：

max-children和max-requests

一臺服務器上運行著nginx php(fpm)xcache，訪問量日均 300W pv左右。最近經常會出現這樣的情況：php頁面打開很慢，cpu使用率突然降至很低，系統負載突然升至很高，查看網卡的流量，也會發現突然降到了很低。這種情況只持續數秒鐘就恢復了。

檢查php-fpm的日志文件發現了一些線索。

代碼如下:

在這幾句的前面，是1000多行的關閉children和開啟children的日志。

原來，php-fpm有一個參數max_requests，該參數指明了，每個children最多處理多少個請求后便會被關閉，默認的設置是500。因為php是把請求輪詢給每個 children，在大流量下，每個childre到達max_requests所用的時間都差不多，這樣就造成所有的children基本上在同一時間 被關閉。

在這期間，nginx無法將 php文件轉交給php-fpm處理，所以cpu會降至很低(不用處理php，更不用執行 sql)，而負載會升至很高(關閉和開啟children、nginx等待php-fpm)，網卡流量也降至很低(nginx無法生成數據傳輸給客戶端)解決問題很簡單，增加children的數量，并且將 max_requests設置未 0或者一個比較大的值：

打開 /usr/local/php/etc/php-fpm.conf調大以下兩個參數 (根據服務器實際情況，過大也不行）

代碼如下:

然后重啟php-fpm。增加緩沖區容量大小將nginx的error log打開，發現“p stream sent too big header while reading response header from upstream”這樣的錯誤提示。查閱了一下資料，大意是nginx緩沖區有一個bug造成的,我們網站的頁面消耗占用緩沖區可能過大。參考老外寫的修 改辦法增加了緩沖區容量大小設置，502問題徹底解決。后來系統管理員又對參數做了調整只保留了2個設置參數：client head buffer，fastcgi buffer size。

request_term inate_timeout

如果主要是在一些post或者數據庫操作的時候出現502這種情況，而不是在靜態頁面操作中常見，那么可以查看一下php-fpm.conf設置中的一項：

request_term inate_timeout

這個值是 max_execution_time，就是fast-cgi的執行腳本時間。

0s

0s為關閉，就是無限執行下去。（當時裝的時候沒仔細看就改了一個數字）問題解決了，執行很長時間也不會出錯了。優化fastcgi中，還可以改改這個值5s看看效果。

php-cgi進程數不夠用、php執行時間長、或者是php-cgi進程死掉，都會出現502錯誤。

LNMP一鍵安裝包官方的：

第一種原因：目前lnmp一鍵安裝包比較多的問題就是502 Bad Gateway，大部分情況下原因是在安裝php前，腳本中某些lib包可能沒有安裝上，造成php沒有編譯安裝成功。

解決辦法：可以嘗試根據lnmp一鍵安裝包中的腳本手動安裝一下，看看是什么錯誤導致的。

第二種原因：

在 php.ini里，eaccelerator配置項一定要放在Zend Optim izer配置之前，否則也可能引起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_term inate_timeout，但是這個值不是通用的，而是需要自己計算的。

在安裝好使用過程中出現502問題，一般是因為默認php-cgi進程是5個，可能因為phpcgi進程不夠用而造成502，需要修改/usr/local/php/etc/php-fpm.conf將其中的max_children值適當增加。

計算的方式如下：

如果你的服務器性能足夠好，且寬帶資源足夠充足，PHP腳本沒有系循環或BUG的話你可以直接將 request_term inate_timeout設置成0s。0s的含義是讓PHP-CGI一直執行下去而沒有時間限制。而如果你做不到這一點，也就是說你的PHP-CGI可能出現某個 BUG，或者你的寬帶不夠充足或者其他的原因導致你的PHP-CGI假死那么就建議你給 request_term inate_timeout賦一個值，這個值可以根據服務器的性能進行設定。一般來說性能越好你可以設置越高，20分鐘-30分 鐘都可以。

而max_children這個值又是怎么計算出來的呢？這個值原則上是越大越好，php-cgi的進程多了就會處理的很快，排隊的請求就會很少。設置max_children也需要根據服務器的性能進行設定，一般來說一臺服務器正常情況下每一個php-cgi所耗費的內存在20M左右。

按照官方的答案，排查了相關的可能，并結合了網友的答案，得出了下面的解決辦法。

1、查看php fastcgi的進程數（max_children值）

2、查看當前進程

代碼：top

觀察 fastcgi進程數,假如使用的進程數等于或高于5個，說明需要增加（根據你機器實際狀況而定）

3、調整 /usr/local/php/etc/phpfpm.conf的相關設置

max_children最多 10個進程，按照每個進程20MB內存，最多200MB。request_term inate_timeout執行的時間為60秒，也就是1分鐘。