BLOG

為什麼會出現 WordPress 白屏

所謂白屏，其實是指 WordPress 在執行過程中遇到致命錯誤，但錯誤訊息沒有顯示在頁面上。對訪客來說，看到的只有一片空白。實際上，內容通常仍然存在於資料庫和檔案系統中，只是 PHP 程式在中途停止輸出。

常見的原因包括外掛程式寫得不夠嚴謹、佈景主題程式碼錯誤、PHP 版本更新後產生不相容問題，或是記憶體限制過低等。如果在沒有備份的情況下隨意刪檔、改程式，很可能讓原本可修復的錯誤變成資料永久遺失。

第一步 – 先確認不是本機問題

在動手修改主機設定之前，先排除瀏覽器或裝置本身的問題。

• 使用不同瀏覽器打開網站，例如從 Chrome 換成 Firefox。
• 試著在手機、平板等不同裝置上開啟同一網址。
• 關閉 wifi，改用行動數據連線測試。
• 使用無痕或私密視窗，以避免快取干擾。

如果在多個裝置與網路環境下都只看到白屏，就可以合理推斷問題出在伺服器或網站本身，而不是單一電腦。

第二步 – 測試後台是否仍可登入

接著要確認的，是 WordPress 後台是否還能正常載入。嘗試開啟：

https://你的網域/wp-admin

• 如果後台仍可登入，多半是前台所使用的某個外掛或佈景主題出問題。
• 如果後台也只剩下白屏或顯示嚴重錯誤，則可能是核心檔案、資料庫或 PHP 環境發生更深層的錯誤。

第三步 – 在 cPanel 中建立完整備份

無論錯誤看起來多急迫，第一件事應該是建立備份，而不是立刻刪除外掛或編輯程式碼。登入 cPanel 後，找到 Backup 或 Backup Wizard 功能。

• 選擇建立完整帳號備份，如果主機商有提供此選項。
• 等待系統產生備份檔案，這個過程可能需要一段時間。
• 備份完成後，將檔案下載到自己的電腦，並另外存放在雲端與外接硬碟上。

第四步 – 使用 FileZilla 備份網站檔案

除了 cPanel 備份外，建議再透過 FTP 客戶端下載一份網站檔案。FileZilla 是一款免費、開源的 FTP 用戶端，支援 Windows、macOS 與 Linux。

• 在 FileZilla 中輸入主機名稱、帳號、密碼與連接埠。
• 連線後，找到 public html 或 www 目錄。
• 將整個 WordPress 安裝目錄下載到本機資料夾中。

第五步 – 透過 phpMyAdmin 匯出資料庫

WordPress 的貼文、頁面、選單、使用者等重要資料都儲存在資料庫中，因此必須另外匯出備份。

• 在 cPanel 中啟動 phpMyAdmin。
• 選取對應的 WordPress 資料庫。
• 使用匯出功能，選擇快速模式與 SQL 格式。
• 下載 .sql 檔案並妥善保存。

第六步 – 檢查錯誤日誌，尋找致命錯誤

備份完成後，就可以開始查找根本原因。許多主機在 cPanel 裡提供 Error log 或類似功能，可以看到近期的伺服器與 PHP 錯誤。

• 留意是否出現 Fatal error 或 Parse error 字樣。
• 記錄錯誤訊息中提到的檔案路徑與行號。
• 檢查路徑中是否包含 wp content plugins 或 wp content themes。

第七步 – 透過 FTP 暫時停用可疑外掛

若無法登入後台，就只能在檔案層級關閉外掛。在 wp content plugins 目錄中找到可疑外掛的資料夾，將它改名，例如 contact form 7 改為 contact form 7 disabled。WordPress 找不到該資料夾時，會自動視為外掛未安裝並停用。

第八步 – 切換回預設佈景主題

若停用外掛仍無法解決問題，接著要排除佈景主題的影響。可以在 wp content themes 目錄中暫時將目前佈景主題資料夾改名，讓 WordPress 嘗試啟用預設佈景主題。如果網站在預設佈景主題下可以正常顯示，就表示原本的佈景主題程式需要開發者進一步檢查。

第九步 – 檢查 PHP 版本與記憶體限制

有時候白屏與 PHP 環境有關，例如主機自動升級了 PHP 版本，導致舊版外掛不相容。多數主機在 cPanel 中提供 PHP 版本選擇工具，可以查看並切換版本。同時應留意 memory limit 設定是否過低，必要時提高限制。

第十步 – 何時該交給專業人員處理

當你已經完成備份、檢查錯誤日誌、停用外掛、測試佈景主題以及調整 PHP 設定後，若問題依然存在，就很適合交由專業人員來處理。此時你已經準備好了備份和相關資訊，專業人士便能以較少時間鎖定問題根源，並降低修復過程中的風險。

延伸閱讀與官方資源

• WordPress 調試說明：https://wordpress.org/support/article/debugging-in-wordpress/
• 常見疑難排解 FAQ：https://wordpress.org/support/article/faq-troubleshooting/
• FileZilla FTP 用戶端（免費）：https://filezilla-project.org/
• phpMyAdmin 官方網站：https://www.phpmyadmin.net/