跳到主要內容
WP 解題所

文章

WordPress 白畫面怎麼辦?先保留錯誤,再逐層隔離

WordPress 白畫面主題資訊圖

先做這件事

WordPress 白畫面:不要在沒有備份時連續試錯

白畫面通常是 PHP 致命錯誤、記憶體不足、外掛/主題衝突或不完整更新。第一步是保存錯誤時間、URL 與日誌,而不是反覆重新整理。

本文聚焦「先看伺服器與 WordPress 錯誤紀錄,再隔離最近變更,不以盲目停用全部外掛起手。」。對應的使用情境是:網站或後台只剩空白,希望安全找出原因並恢復。。排查時請保存每一步的時間、畫面與日誌差異,才能把同時發生但無關的變更排除。

排查原則:先保存錯誤與現況,再從低風險、可回復的檢查開始;一次只改一個變因。

問題症狀

  • 前台整頁空白或只部分頁面空白
  • 後台登入後白畫面
  • 伺服器回 500 但頁面沒有可見錯誤

先不要清除所有證據。保存 HTTP 狀態、錯誤時間、瀏覽器 Network 與最近部署紀錄,再判斷問題在前端、WordPress 或主機層。

可能原因

  1. 01最近更新的外掛或主題發生 PHP 致命錯誤。需要用錯誤日誌、Network 或隔離測試確認,不應只因時間接近就下結論。
  2. 02PHP 記憶體耗盡。需要用錯誤日誌、Network 或隔離測試確認,不應只因時間接近就下結論。
  3. 03快取仍提供損壞或不完整輸出。需要用錯誤日誌、Network 或隔離測試確認,不應只因時間接近就下結論。
WordPress 白畫面重點與步驟說明圖
WordPress 白畫面的操作重點、檢查順序與注意事項示意。圖片由本站依本文內容原創製作。

修改前備份

先建立檔案與資料庫完整備份,下載到站外位置並確認可以讀取;另保存外掛、主題、PHP 版本與目前錯誤畫面。

除了檔案和資料庫,另保存外掛、主題、PHP、WordPress 版本與目前設定畫面,才能在回復時重建相同環境。

由低風險到高風險的排查順序

  1. 1. 確認 HTTP 狀態與受影響範圍
    這一步保持唯讀或可快速回復,先蒐集證據再改設定。
  2. 2. 查看主機 PHP error log 與 WordPress debug.log
    這一步保持唯讀或可快速回復,先蒐集證據再改設定。
  3. 3. 回想最近更新、部署或版本切換
    每完成一步就重測同一個最小重現,確認問題是否改變。
  4. 4. 在測試環境停用單一可疑元件
    每完成一步就重測同一個最小重現,確認問題是否改變。
  5. 5. 套用最小修正並重測前台、後台與表單
    只把已在測試環境通過的最小變更套用到正式站,並立刻跑回歸測試。

低風險檢查應先於版本切換、資料庫修改與全站停用。若證據已排除某一層,不要為求快速又重做高風險動作。

如何確認修復成功

前台首頁、文章、登入與主要表單均可載入,HTTP 200,日誌不再新增同一 Fatal error。

  • 以原本的最小重現步驟再次測試。
  • 檢查首頁、登入、REST API、表單與網站最重要的交易流程。
  • 查看 PHP error log、瀏覽器 Console 與 Network 是否新增錯誤。
  • 以 390px 手機寬度確認沒有版面級橫向溢位。

把症狀與證據對成一條排查路徑

目前看到的症狀 先驗證的原因 最小安全動作
前台整頁空白或只部分頁面空白 最近更新的外掛或主題發生 PHP 致命錯誤 確認 HTTP 狀態與受影響範圍
後台登入後白畫面 PHP 記憶體耗盡 查看主機 PHP error log 與 WordPress debug.log
伺服器回 500 但頁面沒有可見錯誤 快取仍提供損壞或不完整輸出 回想最近更新、部署或版本切換

這張表不是用來直接判定根因,而是把「看到什麼、要查什麼、哪個動作可回復」放在同一列。若第一列的證據不成立,就不要跳到高風險修改。

如何還原

若修改後問題加劇,立即還原剛才變更的檔案或設定;無法確定影響範圍時,用已驗證備份在測試環境還原,不要在正式站連續試錯。

回退需與部署方式一致:檔案、資料庫 schema 與設定若同時改變,就要使用相容版本一起回復。

何時應停止自行操作

若沒有可還原備份、錯誤影響付款或個資、發現惡意程式,或需要直接修改資料庫但不理解關聯,應停止自行操作並尋求專業協助。

停止不是放棄,而是避免把可復原的錯誤變成停機、資料損失或資安事件。準備好時間線、備份、錯誤日誌與已嘗試步驟,能顯著縮短專業人員的診斷時間。

常見問題

可以直接在正式站測試嗎?

不建議。先備份並在測試環境重現,正式站只套用已驗證的最小變更。

需要關閉所有外掛嗎?

不應在沒有計畫時一次關閉。先保存清單,再用隔離或健康檢查方式逐步排除。

修好後要做什麼?

清除必要快取、重測主要流程、保存變更紀錄並確認監控沒有新錯誤。

官方文件與查核來源

以下文件用於核對 WordPress、WooCommerce、PHP 或資料庫行為。第三方外掛與主機設定仍需查閱該產品當前版本的正式文件。