萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 軟體知識 >  >> 系統工具

Nginx 502 Bad Gateway 徹底排查指南:從 FastCGI 進程、超時、緩衝區到 PHP-FPM 參數調優

Nginx 502 錯誤**本質是反向代理後端異常**,非 Nginx 自身故障,但錯誤頁甩鍋 Nginx 讓排查誤入歧途。本文整理系統化排查路徑與參數調優方案,直擊根因。

502 觸發機制

proxy_next_upstream 定義後端故障切換條件,默認 error timeout。常見觸發:

  • error:後端掛掉/斷連
  • timeout:讀取阻塞超時
  • http_500/503:後端返回 500/503(慎用 http_500,會吞沒後端堆棧追蹤,誤導開發以為 Nginx 故障)

建議配置:proxy_next_upstream error timeout invalid_header http_503;(保留 503 因 Resin 掛掉常返回 503)。

優先排查兩步

  1. 檢查 PHP-FPM 進程數是否足夠
    netstat -anpo | grep "php-cgi" | wc -l
    若實際進程數逼近 max_children,需增大。
  2. 增加 FastCGI 超時時間(nginx.conf http 段):
    fastcgi_connect_timeout 300;
    fastcgi_send_timeout 300;
    fastcgi_read_timeout 300;

    同步調大 php.ini memory_limit(如 64M),重啟 Nginx/PHP-FPM。

進階三大調優方向

1. max_children 與 max_requests 平衡

現象:PHP 頁面突變慢、CPU 驟降、負載飆高、網卡流量驟降,持續數秒恢復。
原因:max_requests 默認 500,大流量下所有 children 近同一時間達上限**集體重啟**,Nginx 無後端可用。
對策:php-fpm.conf 調大:

<value name="max_children">5120</value>
<value name="max_requests">600</value>  或設 0(不限制)

重啟 php-fpm 生效。

2. 增加緩衝區容量

錯誤日誌:upstream sent too big header while reading response header from upstream
調整兩參數即解:
client_header_buffer_size、fastcgi_buffer_size

3. request_terminate_timeout 設置

若 502 集中在 POST/數據庫操作:
request_terminate_timeout = max_execution_time(FastCGI 執行腳本上限)
設 0s = 無限制(適合性能好、無死循環環境);
否則設 20-30 分鐘防假死佔用資源。

LNMP 一鍵包常見五大原因速查表

原因排查/解決
PHP 編譯缺 lib 包按安裝腳本手動編譯 PHP,看具體報錯
php.ini 中 eaccelerator 配置在 Zend Optimizer 之前調整順序:eaccelerator 在 Zend 後
默認 php-cgi 進程數 5 不夠改 /usr/local/php/etc/php-fpm.conf max_children
PHP 執行超時改 php.ini max_execution_time = 300
磁盤空間不足(如 MySQL 日誌佔滿)清理日誌/擴容

系統化排查:先查進程數與超時 → 再調 max_children/max_requests/緩衝區/terminate_timeout → 結合 LNMP 常見坑位 → **502 非 Nginx 鍋,後端調優才是正解**。

copyright © 萬盛學電腦網 all rights reserved