WordPress 網站突然跳出 502 Bad Gateway 或 504 Gateway Timeout,最容易做的事就是一直重新整理、清快取、停外掛,甚至直接懷疑主機不夠大。
排查前應先區分 502 與 504 的錯誤類型。502 是「有拿到東西,但上游回應無效」;504 是「等太久,根本沒在時間內拿到回應」。如果一開始就把兩個錯誤混在一起排查,很容易在錯的層級一直試。
本文以 WordPress、Nginx、PHP-FPM 與 Cloudflare/CDN 的常見架構,整理排查順序、需要聯絡主機商的情況及資源調整時機。
502 和 504 差在哪?先看懂這張表
| 狀態碼 | 正式名稱 | 代表意思 | 優先排查方向 |
|---|---|---|---|
| 502 | Bad Gateway | 閘道/代理收到上游的無效回應 | Origin、PHP-FPM、Web Server、代理層、CDN |
| 504 | Gateway Timeout | 閘道/代理等不到上游回應 | 慢查詢、長時間 PHP、外部 API、伺服器過載 |
| 500 | Internal Server Error | 伺服器遇到無法處理的內部錯誤 | PHP、外掛、主題、設定、權限 |
| 503 | Service Unavailable | 服務暫時無法處理請求 | 維護、過載、PHP workers、資源耗盡 |
MDN 對 502 與 504 的定義很明確:502 是代理拿到「無效回應」;504 則是代理沒有在時間內收到回應。這個差別就是整篇排查的核心。
為什麼 WordPress 會出現 502 或 504?先看懂請求鏈
一般 WordPress 網站不一定只有「瀏覽器 → WordPress」兩層。實際上常見流程可能是:
瀏覽器 → Cloudflare/CDN → Nginx 或 Apache → PHP-FPM → WordPress → 資料庫/外部 API
只要其中一層向下一層取得資料時出問題,前面的代理就可能回傳 502 或 504。因此看到錯誤碼時,第一件事不是猜外掛,而是先判斷是哪一層在等待哪一層。
502 Bad Gateway 常見原因
502 比較常代表「上游有回應,但這個回應不能被正常使用」。在 WordPress 環境裡,常見方向包括:
- PHP-FPM 程序崩潰、被終止或重啟。
- Nginx/反向代理連不到上游服務。
- Origin 原始主機異常回應。
- 主機瞬間過載,造成上游連線異常。
- CDN、反向代理與來源主機之間的連線問題。
- 伺服器或壓縮回應格式異常。
502 的來源未必是 Cloudflare,仍須檢查錯誤發生在哪一層。Cloudflare 官方目前也把 502/504 分成來源主機產生與 Cloudflare 端產生兩種情況,必須先分辨來源。
504 Gateway Timeout 常見原因
504 的核心不是「回應內容錯了」,而是上游工作沒有在代理願意等待的時間內完成。WordPress 常見原因包括:
- 某個 PHP 工作執行太久。
- 資料庫查詢太慢或被鎖住。
- 大量匯入、匯出、報表產生或圖片處理。
- 第三方金流、CRM、Email 或其他 API 回應太慢。
- CPU、記憶體或 PHP workers 在尖峰被耗盡。
- 同時間有備份、掃描、排程等重工作一起執行。
看到 504 時,直接把 timeout 拉長有時會讓錯誤晚一點出現,卻不代表問題真的解決。如果根因是慢查詢、死循環或外部 API 卡住,只把等待時間延長,使用者只是等得更久。
WordPress 502/504 的 8 步排查流程
第 1 步:先記錄時間、URL、錯誤碼
至少記錄發生時間、時區、網址、錯誤碼與當時操作,方便比對伺服器紀錄。Cloudflare 官方在 502/504 排查文件也建議先保留這些資訊,方便和 Origin 或伺服器紀錄比對。
錯誤重新整理後即使消失,也要記錄發生時間,尤其是登入、結帳、付款等重要流程反覆出錯時。這些時間點可用來對照 log。
第 2 步:確認是整站、單一頁面,還是特定動作
依序測首頁、一般文章、登入頁、後台、結帳頁。如果只有產生報表、送出表單或結帳時 504,問題很可能靠近該功能所使用的 PHP、資料庫或外部 API;如果整站一起 502,則更應優先看 Origin、PHP-FPM、Web Server 或主機層。
第 3 步:分辨 Cloudflare/CDN 還是 Origin
有 Cloudflare、Bunny CDN、反向代理或 WAF 時,不要把前端看到的錯誤直接等同 WordPress 本身。Cloudflare 官方目前指出,502/504 最常見仍是來源主機回傳,但也存在 Cloudflare 自身產生的 502/504。
如果可以由主機商或技術人員直接測 Origin,就能更快確認:Origin 自己就失敗,重點往主機與應用程式查;Origin 正常、代理後才失敗,才回頭看 CDN、DNS、WAF 或代理設定。
第 4 步:看 PHP-FPM、Web Server 與錯誤紀錄
WordPress 的動態頁面主要由 PHP 處理。PHP-FPM 工作程序不夠、程序崩潰、記憶體不足或執行時間過長,都可能讓前面的 Nginx/代理拿不到正常結果。
主機錯誤紀錄、PHP error log、Nginx/Apache log,通常比「猜是哪個外掛」更有價值。WordPress 官方也提供 WP_DEBUG、WP_DEBUG_LOG 等除錯工具,但這類除錯功能主要適合測試與開發情境,不應把詳細錯誤直接暴露在正式網站前台。
第 5 步:回看最近變更
如果 502/504 是在更新外掛、切換 PHP、調整 CDN、改安全規則或新增第三方串接後開始出現,這些變更值得優先查。但時間吻合只是線索,不能直接把某個外掛判定為根因。
如果證據真的指向外掛,可以依WordPress 外掛衝突安全排錯流程逐步測試。每次只改一個變數,避免網站恢復後仍不知道真正原因。
第 6 步:檢查尖峰資源,而不是只看平均值
CPU 平均只有 20%,不代表開賣那一分鐘沒有衝到 100%。如果錯誤只在直播結束、Email 發送、會員大量登入或結帳尖峰出現,要看錯誤當下的 CPU、記憶體、PHP workers、資料庫連線與 I/O。
如果你的網站有明顯流量尖峰,可以一起看課程網站尖峰流量 10 步準備,先把高峰會同時發生的動態請求與背景工作列出來。
第 7 步:504 要追慢查詢、外部 API 與長工作
如果只有某一種操作固定出現 504,就沿著那個操作往後追:它查了哪些資料?是否呼叫外部服務?有沒有一次處理大量資料?是否在等待金流、CRM 或其他 API?
先找出逾時的工作環節,比全面調高 timeout 更能協助定位問題,因為你是在找「哪一個工作沒有完成」,而不是只處理錯誤畫面。
第 8 步:只有證據顯示資源不足,才考慮升級主機
如果監控持續顯示 CPU、記憶體、PHP workers、資料庫或 I/O 在正常營運流量下撞到上限,而且已排除異常程式、慢查詢與錯誤設定,升級主機才有明確理由。
如果你不確定主機規格該怎麼判斷,可以延伸閱讀課程網站主機規格怎麼看?CPU、記憶體、資料庫與尖峰流量判斷。
502 和 504 可以靠清快取解決嗎?
有時候錯誤會剛好在清快取後消失,但不能因此判定根因就是快取。如果真正問題在 PHP-FPM、資料庫、Origin 過載或外部 API,清快取可能只是讓下一次請求暫時變輕。
比較好的做法,是把清快取當成一個可驗證的假設:清除前後是否能穩定重現?錯誤紀錄有沒有改變?同一操作多測幾次是否都正常?如果沒有證據,就不要把「剛好恢復」當成根因已解決。
如果只有你看到 502/504,要先查自己的網路嗎?
502/504 多數情況是伺服器、代理或上游服務問題,不是訪客端能直接修好的。但如果只有你遇到、其他地區與其他使用者都正常,而且你正在使用 VPN、自訂代理、防火牆或特殊 DNS,才值得再檢查本機網路設定。
付款或送出表單時遇到錯誤,先核對交易與表單紀錄,再決定是否重試,以免重複建立訂單或扣款。
把這 7 項資料交給主機商,排查會快很多
- 實際錯誤碼:502 還是 504。
- 完整出錯網址。
- 發生日期、時間與時區。
- 是否能穩定重現,以及重現步驟。
- 最近更新、安裝或設定變更。
- 錯誤當下的 CPU、記憶體、PHP workers 與資料庫狀況。
- PHP、Web Server、CDN/代理層可以取得的錯誤紀錄。
只跟客服說「網站剛剛 502」通常很難定位;能把時間、URL、操作與資源狀況一起提供,技術人員才有機會對到真正的錯誤紀錄。
從「什麼時候出錯」反推 502/504 的原因
錯誤碼本身只能指出失敗類型,真正縮小範圍的關鍵,往往是什麼情境會觸發。如果把症狀和時間點一起看,通常比照著網路教學把所有修法做一遍有效。
| 出錯情境 | 優先懷疑方向 | 先查什麼 |
|---|---|---|
| 全站突然 502 | Origin、PHP-FPM、Web Server、代理連線 | 主機與 Web Server log、服務狀態 |
| 只有結帳或登入 504 | 動態 PHP、資料庫、第三方 API | 該請求執行時間、慢查詢、外部服務 |
| 流量高峰才 502/504 | CPU、記憶體、PHP workers、資料庫 | 錯誤當下的資源監控 |
| 更新外掛後開始出錯 | 相容性、程式錯誤、資源消耗 | 最近變更與錯誤紀錄 |
| 固定時間出錯 | 備份、掃描、Cron、批次工作 | 排程時間與資源峰值 |
| 只有透過 CDN 出錯 | 代理、DNS、WAF、Origin 連線 | 直接測 Origin 與代理後結果 |
這張表用來建立排查假設。例如每天備份時才出現 504,可優先比對備份工作與資料庫/CPU 使用情況。
為什麼 502/504 常常一下有、一下又正常?
間歇性錯誤最容易被忽略,因為重新整理後網站又打得開。但這類狀況反而很常和「短時間瓶頸」有關,例如 PHP workers 瞬間被占滿、某筆資料庫查詢偶爾拖很久、第三方 API 不穩,或流量高峰讓 Origin 回應速度大幅下降。
所以間歇性 502/504 最重要的是保存時間點。只要能把錯誤發生的分鐘數,對上主機資源、PHP-FPM、資料庫或 CDN 紀錄,通常比事後在網站正常時做一堆猜測更容易找到問題。
前台正常、後台 504,和整站 504 要分開處理
如果訪客看的快取頁面很正常,只有 WordPress 後台、WooCommerce 訂單、匯出報表或會員管理頁 504,不代表整台主機都壞了。前台快取可能根本沒有執行同樣的 PHP 與資料庫工作。
這種情況應該優先檢查出錯功能本身的查詢、資料量、背景工作與外部串接,而不是因為首頁打得開就排除伺服器端問題;相反地,如果所有動態與靜態頁都一起失敗,排查範圍才更接近 Web Server、Origin、網路或整體資源。
結帳時遇到 502/504,不要立刻重複付款
這一點對 WooCommerce、線上課程與會員網站特別重要。瀏覽器看到 504,只代表前面的代理沒有在期限內拿到回應,不代表後端一定完全沒處理。某些情況下,付款或訂單可能已經成功,只是成功頁沒有及時回到瀏覽器。
因此在付款流程遇到錯誤時,先查訂單、金流後台與付款通知,再決定是否重試。網站端也應避免只用「使用者有沒有看到完成頁」判斷交易是否成功,而要以真正的付款結果與訂單狀態為準。
什麼時候該直接找主機商?
如果你無法取得 PHP-FPM、Nginx/Apache、系統資源或 Origin 層紀錄,排查到這一層就不必硬猜。把錯誤時間、URL、重現步驟與最近變更整理好,請主機商查看伺服器端紀錄通常更有效率。
尤其是全站反覆 502、504、PHP-FPM 頻繁重啟、資源監控明顯撞上限,或問題發生在你沒有權限查看的代理/主機層時,技術支援能看到的證據會比 WordPress 後台更多。
常見問題
502 Bad Gateway 是什麼?
502 表示充當閘道器或代理的伺服器,從上游服務收到無效回應。它通常需要從代理、Web Server、PHP-FPM、Origin 或上游服務之間的連線開始排查。
504 Gateway Timeout 是什麼?
504 表示閘道器或代理在指定時間內等不到上游回應。慢查詢、執行時間過長的 PHP、外部 API 延遲與伺服器過載,都是常見排查方向。
502 跟 504 哪一個比較嚴重?
不能只看數字判斷嚴重程度。偶發一次可能很快恢復,但如果在登入、結帳、付款或流量尖峰反覆出現,兩者都值得追查根因。真正重要的是影響範圍、持續時間與是否能重現。
504 把 timeout 調大就會好嗎?
不一定。如果只是合理工作超過原本設定,調整 timeout 可能有幫助;如果根因是慢查詢、程式異常、外部 API 卡住或資源不足,單純延長 timeout 只是把問題往後拖。
502/504 一定要重啟主機嗎?
不一定。重啟可能暫時清掉卡住的程序,但也會把現場證據一起消掉。能先取得錯誤紀錄、資源監控與重現條件時,先保留證據再處理通常更有利於找根因。
參考資料
MDN Web Docs|502 Bad Gateway;504 Gateway Timeout(2026 年 10 月 6 日查證)
Cloudflare Developers|Error 502 or 504(2026 年 7 月 20 日更新;2026 年 10 月 6 日查證)
WordPress Developer Resources|Debugging in WordPress(2026 年 10 月 6 日查證)
結論:502 看「無效回應」,504 看「等待超時」
遇到 502/504,先確認失敗發生的層級:502 查上游回應為何無效,504 查哪個工作逾時。
把錯誤時間、URL、影響範圍、資源狀況與伺服器紀錄留下來,再一次驗證一個假設,通常比清快取、停外掛、加 timeout、升級主機全部一起做,更快找到真正原因。
