wordpress_debug_log 打開log日誌

一覺醒來，網站突然變成一片死白。或是點進後台，直接跳出「網站遇到重大錯誤」的通知。這是所有網站主最深層的恐懼，也就是俗稱的 WordPress 白屏死機。你不需要急著找外包，用 3 步驟開啟隱藏的除錯模式，自己就能救。

盲目猜測哪一個外掛壞掉，是最沒效率的作法。讓伺服器自己開口說話。我們要把系統的錯誤訊息強制寫進日誌檔，在不驚動訪客的前提下，精準抓出核心病灶。

步驟一：編輯 wp-config.php 開啟除錯模式

首先，透過 FTP 或主機後台的檔案管理員，打開網站根目錄。找到 wp-config.php 檔案。這是控制整個網站底層的核心設定檔。

在檔案中找到 /* That's all, stop editing! Happy publishing. */ 這行字。在這行字的正上方，貼上以下這段黃金程式碼：

// 開啟 Debug 模式
define( 'WP_DEBUG', true );

// 將錯誤記錄到檔案而不是顯示在頁面上
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

步驟二：查看 debug.log 錯誤日誌

代碼生效後，請回到前台，重新對瀏覽器進行重新整理。這時候網頁雖然依然是白屏，但後台系統已經把致命錯誤的原因抓了下來。

再次進到 FTP。進入 /wp-content/ 資料夾。你會看到裡面自動生成了一個名為 debug.log 的純文字檔案。下載並打開它。

日誌的最下方會直接寫出是哪一個檔案、哪一行代碼引發了致命衝突。通常會直接洩漏外掛或佈景主題的名稱，直接找到兇手。

安全建議：除錯後關閉 WP_DEBUG

排查完畢、修復錯誤之後，請務必把 WP_DEBUG 的值改回 false。這牽涉到主機資源與網站安全的雙重問題。

如果長時間保持開啟，日誌檔案會隨著無關緊要的警告訊息（Warning）瘋狂膨脹，迅速吞噬你的伺服器硬碟空間。將其關閉，才是最扎實的運維習慣。

常見問題

開啟WP_DEBUG後網站會直接顯示錯誤畫面嗎？

不會。只要你正確設定WP_DEBUG_DISPLAY為false，錯誤訊息就會被強制隱藏，只會默默記錄到後台的日誌檔中，不影響訪客瀏覽。

為什麼我改了wp-config.php卻沒有產生debug.log檔案？

有兩個可能原因。第一是你的網站目前完全沒有觸發任何錯誤。第二是你的/wp-content/資料夾權限不對，導致伺服器無法寫入檔案，請檢查資料夾權限是否為755。