萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 502 Bad Gateway 與 504 Gateway Time-out 完整排解指南

錯誤含義

  • 502 Bad Gateway:Nginx 已將請求轉發給 PHP-FPM,但 PHP-CGI 進程因資源讀取問題異常終止,未完成回應。
  • 504 Gateway Time-out:Nginx 在等待上游(PHP-FPM)回應時逾時,通常因 PHP-FPM 進程不足或處理緩慢導致請求排隊過久。

核心參數調整

php-fpm.conf 關鍵參數

參數說明建議值
max_childrenPHP-FPM 最大子進程數。依記憶體估算:單進程約 20-30MB,總量不超過可用記憶體 70%。例:1GB 記憶體 → 30-40
request_terminate_timeout單一請求最大執行秒數。0 代表無限制(風險較高),建議設 300-1800 秒視腳本複雜度而定。900 秒(15 分鐘)

nginx.conf 關鍵參數

# FastCGI 相關超時與緩衝
fastcgi_connect_timeout 600;
fastcgi_send_timeout    600;
fastcgi_read_timeout    600;
fastcgi_buffer_size     256k;
fastcgi_buffers         16 256k;
fastcgi_busy_buffers_size 512k;
fastcgi_temp_file_write_size 512k;

# 客戶端緩衝與超時
client_header_buffer_size 256k;
large_client_header_buffers 4 256k;
client_body_buffer_size 256k;
client_header_timeout 3m;
client_body_timeout   3m;
send_timeout          3m;
client_max_body_size  50m;
keepalive_timeout     120;

長效優化策略

  1. 定時平滑重啟 PHP-FPM:透過 crontab 定期發送 reload 訊號,釋放記憶體碎片。
  2. 調整 max_children 與 max_requests:雲主機建議 max_children 5-10,max_requests 1000-2000,降低 max_requests 可縮短進程回收週期,減輕偶發高記憶體操作影響。
  3. 監控與告警:監控 PHP-FPM 進程數、記憶體使用、請求延遲,異常時自動重啟或擴容。

臨時緩解方案

調大上述超時與緩衝參數,並適度增加 max_children,觀察錯誤頻率是否下降。

copyright © 萬盛學電腦網 all rights reserved