Nginx 502 錯誤**本質是反向代理後端異常**,非 Nginx 自身故障,但錯誤頁甩鍋 Nginx 讓排查誤入歧途。本文整理系統化排查路徑與參數調優方案,直擊根因。
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)。
netstat -anpo | grep "php-cgi" | wc -lmax_children,需增大。fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300;php.ini memory_limit(如 64M),重啟 Nginx/PHP-FPM。現象: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 生效。
錯誤日誌:upstream sent too big header while reading response header from upstream
調整兩參數即解:
client_header_buffer_size、fastcgi_buffer_size
若 502 集中在 POST/數據庫操作:
request_terminate_timeout = max_execution_time(FastCGI 執行腳本上限)
設 0s = 無限制(適合性能好、無死循環環境);
否則設 20-30 分鐘防假死佔用資源。
| 原因 | 排查/解決 |
|---|---|
| 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 鍋,後端調優才是正解**。