502 Bad Gateway

---

nginx ：nginx伺服器常見錯誤疑難排解與深度解析

遭遇「502 Bad Gateway」？別慌，nginx錯誤全解析

「哎呀！怎麼又來了？」當你正專心致志地瀏覽網頁，突然螢幕上跳出一個令人掃興的訊息：「502 Bad Gateway」，伴隨著 `nginx` 的字樣，是不是感覺整個人都不好了？別擔心，相信很多人都曾遇過這個惱人的狀況。這個錯誤訊息，簡而言之，就是你的瀏覽器（或者說，你的裝置）嘗試連接一個網頁伺服器，但中間的伺服器（通常就是 `nginx`）在跟上游伺服器（可能是 PHP-FPM、Apache、Node.js 等應用程式伺服器）溝通時，收到了無效的回應。可以想像成，你在打電話給客服，但客服轉接給另一個部門，那個部門卻沒人接聽，或者說了些聽不懂的話，最後客服就只能無奈地跟你說「抱歉，無法為您服務」，這就是 502 的基本概念啦！

今天，我們就要深入淺出地來剖析這個「502 Bad Gateway」錯誤，特別是當它伴隨著 `nginx` 出現時，到底藏著哪些玄機？我們會從這個錯誤的本質出發，一步步拆解可能的原因，並提供一系列實用的疑難排解步驟。無論你是網站站長、開發者，還是偶爾遇到這個問題的一般使用者，都能從這篇文章中獲得豐富的資訊和解決方案。讓我們一起來揭開 502 錯誤的神秘面紗吧！

502 Bad Gateway 的根本原因：溝通不良惹的禍

首先，我們得明白 502 錯誤的核心問題是什麼。當你的瀏覽器向一個網址發出請求時，這個請求會經過一系列的伺服器。在許多現代的網站架構中，`nginx` 扮演著「反向代理伺服器」的角色。它的主要任務是高效地接收來自用戶端的請求，然後將這些請求轉發給後端的「應用程式伺服器」（例如，處理 PHP 程式碼的 PHP-FPM，或是運行 Node.js 應用的伺服器）。之後，應用程式伺服器處理完畢，再將結果傳回給 `nginx`，`nginx` 最後再把處理好的網頁內容回傳給你的瀏覽器。

那 502 錯誤發生在哪個環節呢？就是當 `nginx` 在等待後端應用程式伺服器的回應時，卻收到了「不正常」或「無效」的回應。這可能的原因很多，但總結來說，就是 `nginx` 和後端應用程式伺服器之間的「溝通」出了問題。這種溝通不良，就像人與人之間的對話，如果一方聽不懂，或者說話含糊不清，就會造成誤解和無法進行下一步。在伺服器架構裡，這種「誤解」就會被歸類為 502 Bad Gateway。

深入解析 502 錯誤的常見元凶

那麼，具體是哪些因素可能導致這種溝通不良，進而引發 502 錯誤呢？讓我們來一一細數：

• 上游伺服器離線或崩潰： 這是最常見的原因之一。如果你的後端應用程式伺服器（比如 PHP-FPM、Node.js 應用等）突然停止運作、崩潰、或因為過載而無響應，`nginx` 就會因為無法聯繫到它而返回 502 錯誤。
• 上游伺服器回應超時： 有時候，後端應用程式伺服器並非崩潰，而是處理請求的時間太長了。如果處理時間超過了 `nginx` 設定的超時限制，`nginx` 就會認為這個請求失敗了，從而給出 502。這就像你打電話給朋友，他說「等一下」，結果等了半小時還沒好，你是不是就掛電話了？
• 網路連接問題： `nginx` 和後端應用程式伺服器之間可能存在網路延遲、封包丟失，或者防火牆阻擋等網路問題，導致 `nginx` 無法正常接收後端的回應。
• 配置錯誤： 無論是 `nginx` 的配置，還是後端應用程式伺服器的配置，如果存在錯誤，例如 `nginx` 指向了錯誤的後端伺服器地址或埠號，或者後端伺服器沒有正確監聽埠號，都會導致連線失敗。
• 資源耗盡： 如果伺服器上的 CPU、記憶體、磁碟空間等資源被耗盡，後端應用程式伺服器就可能無法正常運作，進而導致 `nginx` 無法收到有效回應。
• DNS 解析問題： 雖然較少見，但如果 `nginx` 在嘗試連接後端伺服器時，DNS 解析出現問題，也可能導致連線失敗。

網站站長必看：排查 502 Bad Gateway 的實用步驟

如果你是網站的管理者，遇到 502 Bad Gateway 錯誤，可千萬別慌亂。按照以下步驟，一步步來排查，通常都能找到問題的根源：

第一步：檢查伺服器日誌

日誌文件是伺服器故障排除的「黃金法則」。`nginx` 的錯誤日誌（通常位於 `/var/log/nginx/error.log`）和應用程式伺服器的日誌（例如 PHP-FPM 的日誌）會記錄下許多關鍵信息。仔細閱讀這些日誌，尋找與 502 錯誤發生時間點相關的錯誤訊息，通常就能直接指出問題所在。

• 查看 `nginx` 錯誤日誌： 查找類似 `upstream prematurely closed connection while reading response header from upstream`、`connect() failed (111: Connection refused) while connecting to upstream` 等錯誤訊息。
• 查看應用程式伺服器日誌： 如果是 PHP-FPM，檢查其日誌中是否有 `server reached pm.max_children setting`（子進程達到上限）或 `pool is offline` 等訊息。

第二步：確認上游伺服器是否正常運作

502 錯誤最常見的原因就是後端應用程式伺服器出現問題。你需要確認它是否仍在運作。

• 檢查程序狀態： 使用系統指令檢查你的應用程式伺服器程序（如 `systemctl status php-fpm`、`systemctl status your_node_app`）是否正在運行。
• 嘗試重啟上游伺服器： 有時候，簡單地重啟一下應用程式伺服器就能解決臨時性的問題。例如：`sudo systemctl restart php-fpm`。

第三步：檢查網路連線與配置

確保 `nginx` 和後端應用程式伺服器之間能夠順暢溝通。

• 驗證 `nginx` 配置： 檢查 `nginx` 的設定檔（通常在 `/etc/nginx/nginx.conf` 或 `/etc/nginx/sites-available/your_site`）中的 `proxy_pass` 指令，確認它指向的後端伺服器地址和埠號是否正確。
• 測試埠號連線： 在 `nginx` 伺服器上，嘗試使用 `curl` 或 `telnet` 命令連接後端伺服器的埠號，看是否能成功連線。例如，如果 PHP-FPM 監聽在 `127.0.0.1:9000`，你可以嘗試 `curl http://127.0.0.1:9000` 或 `telnet 127.0.0.1 9000`。
• 檢查防火牆： 確保伺服器防火牆（如 `ufw` 或 `iptables`）沒有阻止 `nginx` 與後端伺服器之間的通訊。

第四步：檢查伺服器資源使用情況

資源不足會嚴重影響伺服器效能。

• 查看 CPU 和記憶體使用率： 使用 `top` 或 `htop` 命令檢查伺服器的 CPU 和記憶體使用情況。如果發現有程序佔用了過高的資源，可能需要進一步排查是哪個應用程式導致的。
• 檢查磁碟空間： 使用 `df -h` 命令檢查磁碟空間是否已滿。

第五步：調整超時設定（謹慎操作）

如果你的應用程式確實需要較長的處理時間，可以考慮調整 `nginx` 的超時設定。但這必須謹慎，因為過長的超時可能導致伺服器負載過重。你需要修改 `nginx` 的設定檔，並增加以下參數：

proxy_connect_timeout 600;
proxy_send_timeout 600;
proxy_read_timeout 600;
fastcgi_send_timeout 600;
fastcgi_read_timeout 600;

這些數值（單位是秒）可以根據你的實際需求進行調整。修改完畢後，記得重新載入 `nginx` 的配置：`sudo systemctl reload nginx`。

一般使用者：遇到 502 Bad Gateway 時該怎麼辦？

如果你不是網站的管理者，只是單純地在瀏覽網頁時遇到了 502 Bad Gateway，那麼你的處理方式會簡單許多：

1. 重新整理頁面： 這是最簡單也最常見的解決方法。按下 `F5` 或瀏覽器上的重新整理按鈕，有時候只是暫時性的網路波動或伺服器小狀況，重新整理後就可能恢復正常。
2. 清除瀏覽器快取和 Cookie： 有時候，瀏覽器儲存的舊資料可能會與伺服器產生衝突。嘗試清除瀏覽器的快取和 Cookie，然後再試試看。
3. 檢查網路連線： 確認你自己的網路連線是否穩定。嘗試開啟其他網站，看看是否正常。
4. 嘗試其他瀏覽器或裝置： 換一個瀏覽器，或者使用手機的行動網路嘗試訪問該網站，看看問題是否是出在你自己的裝置或瀏覽器上。
5. 稍後再試： 如果以上方法都無效，很可能問題出在網站伺服器端。這時候，最好的方法就是稍後再回來嘗試訪問。
6. 聯繫網站管理者（如果可能）： 如果該網站對你很重要，且問題持續存在，你可以嘗試尋找網站的聯絡方式，告知他們你遇到的問題。

常見相關問題與深度解答

Q1：502 Bad Gateway 錯誤會影響 SEO 嗎？

絕對會！Google 和其他搜尋引擎都非常重視網站的可用性和使用者體驗。頻繁出現的 502 Bad Gateway 錯誤，會讓搜尋引擎爬蟲認為你的網站不穩定、不可靠。這不僅會影響你的網站在搜尋結果中的排名，甚至可能導致網站在索引中被移除。因此，及時解決 502 錯誤，對於網站的 SEO 表現至關重要。

當搜尋引擎爬蟲遇到 502 錯誤時，它會暫時將該頁面標記為無法訪問，並在稍後嘗試重新抓取。但如果這種情況持續發生，爬蟲的信心就會大打折扣，導致網站的整體權重下降。我們都知道，使用者體驗是 Google 排名的重要因素之一，而 502 錯誤無疑是使用者體驗的一大殺手！

Q2：我的網站使用了 Cloudflare，為什麼還會出現 502 Bad Gateway？

這個情況很常見！Cloudflare 作為一個 CDN（內容分發網路）和安全服務商，它本身也是一個反向代理。當你的網站配置了 Cloudflare 後，用戶端的請求實際上是先到達 Cloudflare 的伺服器，然後 Cloudflare 再將請求轉發到你自己的源站伺服器。這時候，502 Bad Gateway 錯誤就可能發生在兩個環節：

• Cloudflare 與你的源站伺服器之間： 這是最常見的情況。此時，問題可能出在你的源站伺服器（例如上面提到的 `nginx` 或是後端應用程式伺服器）無法回應 Cloudflare 的請求。
• Cloudflare 伺服器內部： 雖然較少見，但 Cloudflare 的伺服器本身也可能發生臨時性的問題，導致它無法成功從你的源站獲取內容。

如果你在使用 Cloudflare 時遇到 502，建議你先檢查你的源站伺服器日誌和狀態，確保它們運作正常。Cloudflare 的儀表板中通常也會提供一些關於錯誤的資訊，可以輔助你判斷問題點。有時候，簡單地清除 Cloudflare 的快取，或是暫時停用 Cloudflare (在「Caching」->「Configuration」->「Purge Everything」) 來直接測試源站，也能幫助你釐清問題是出在 Cloudflare 端還是源站端。

Q3：PHP-FPM 導致的 502 Bad Gateway 錯誤，常見的排查重點是什麼？

PHP-FPM (FastCGI Process Manager) 是處理 PHP 網頁的常見應用程式伺服器。當 `nginx` 透過 FastCGI 協議與 PHP-FPM 溝通時，如果 PHP-FPM 出現問題，就會導致 502 錯誤。常見的排查重點包括：

• PHP-FPM 進程數不足： 如果網站流量突然增大，而 PHP-FPM 的 `pm.max_children`（最大子進程數）設定得太低，就會導致所有進程都被佔用，新的請求無法被處理。你會在 PHP-FPM 的日誌中看到類似 `server reached pm.max_children setting` 的訊息。解決方法是適當調高 `pm.max_children` 的值，並確保伺服器有足夠的記憶體支撐。
• PHP 腳本執行超時： 如果某個 PHP 腳本執行時間過長，超過了 `max_execution_time`（PHP 設定）或 `fastcgi_read_timeout`（Nginx 設定），也會導致 PHP-FPM 無法及時回應。
• PHP-FPM 運行模式問題： PHP-FPM 可以運行在 `static`、`dynamic` 或 `ondemand` 模式。不同的模式有不同的資源管理機制，錯誤的配置可能會導致效能問題。
• PHP-FPM 監聽地址問題： 確保 `nginx` 設定檔中的 `fastcgi_pass` 指令指向的 PHP-FPM 監聽地址（例如 `unix:/var/run/php/php7.4-fpm.sock` 或 `127.0.0.1:9000`）與 PHP-FPM 的設定檔（`php-fpm.conf` 或 `pool.d/.conf`）中的 `listen` 指令一致。
• PHP 錯誤： 雖然 PHP 錯誤通常會顯示為 500 Internal Server Error，但某些嚴重的 PHP 錯誤，或者 PHP 崩潰，也可能導致 PHP-FPM 無法正常回應，進而引發 502。檢查 PHP 的錯誤日誌（`error_log`）是很有必要的。

在處理 PHP-FPM 相關的 502 錯誤時，深入理解 PHP-FPM 的配置參數，例如 `pm.max_children`、`pm.start_servers`、`pm.min_spare_servers`、`pm.max_spare_servers` 以及 `request_terminate_timeout` 等，對於進行精確的調優非常重要。這些參數的合理設置，能有效平衡伺服器資源的使用與網站的請求處理能力。

Q4：我只是個普通使用者，經常遇到 502 錯誤，怎麼辦？

對於普通使用者來說，頻繁遇到 502 錯誤，最可能的原因是你正在訪問的網站本身存在問題。以下是一些你可以嘗試的額外步驟：

• 檢查是否為特定網站問題： 試試看能否訪問其他網站。如果其他網站都正常，那麼問題很可能就出在你正試圖訪問的這個網站上。
• 使用網站狀態檢查工具： 有些線上工具可以幫助你檢查特定網站的運行狀態，例如 "Down For Everyone Or Just Me?" (downforeveryoneorjustme.com)。如果工具顯示該網站確實無法訪問，那就表示這不是你個人的問題。
• 尋求其他用戶的意見： 如果你是在一個論壇或社群媒體上看到其他人也在討論同一個網站的 502 錯誤，這就更證實了問題不在你這邊。
• 耐心等待： 如前所述，最有效的辦法就是耐心等待網站管理者修復問題。

記住，作為普通使用者，你的操作能力是有限的。當伺服器端出現問題時，最明智的做法就是給予對方時間和空間去解決。過多的重複操作，反而可能增加伺服器負擔，對網站恢復不利。

結語

「502 Bad Gateway」這個錯誤訊息，雖然看似簡單，但背後卻可能牽涉到複雜的伺服器架構和配置。透過對 `nginx` 的理解，以及對上游伺服器、網路通訊、伺服器資源等多方面的深入分析，我們能夠更有效地診斷和解決這個惱人的問題。無論你是伺服器管理者還是普通使用者，希望這篇文章能為你提供清晰的思路和實用的工具，讓你不再對這個錯誤感到束手無策。記住，每一次的錯誤，都是一次學習和優化的機會！