生活分享

WordPress 出現 500 錯誤：從記錄檔找原因

WordPress 突然出現 500 錯誤時，先記下故障範圍和最近變更，再用錯誤記錄縮小原因。本篇說明復原模式、外掛隔離、PHP 記憶體與伺服器設定的判讀順序，提供安全蒐證、單一步驟回復及修復後驗收清單，讓台灣一般站長能與主機客服交換有用資訊，避免反覆重裝而失去資料。

更新日期: 閱讀時間約 6 分鐘

文件、伺服器與螢幕依序連接的原創插圖，象徵透過錯誤記錄恢復網站操作。
圖片：Mokaair (© Mokaair)

網站首頁打得開，按下表單卻顯示 500；或剛更新外掛，前台與後台一起失去回應。相同的錯誤畫面可能來自不同位置，單看數字無法判定是哪個外掛壞了。排查的起點是建立一條可核對的時間線。

以下以個人工作室的 WordPress 網站為例，把處理分成記錄、定位、最小回復與功能驗收。這是一套依官方文件整理的操作方法，沒有在你的網站執行測試；主機控制台名稱與可用權限仍需依實際服務確認。

先保存故障現場與最近變更

記錄第一次發現的時間及時區、出錯網址、操作動作和當時是否登入。不要只寫「網站掛了」，而要寫「台灣時間下午兩點，訪客送出詢問表單後看到 500，首頁仍可開啟」。這樣才能在伺服器記錄中找到相近事件。

接著列出最後正常到故障之間的修改：外掛更新、PHP 切換、佈景程式、搬家或主機規則。先保存現有檔案及資料庫狀態，避免後續調整覆蓋唯一線索。有訂單或報名資料的網站，應讓負責人知道受影響範圍，暫停會反覆產生不確定結果的操作。

  1. 截下錯誤畫面並保留網址，移除分享截圖中的個人資料。
  2. 分別測試首頁、單篇文章、登入頁與原本出錯功能，記錄成功或失敗。
  3. 整理最近變更及既有備份時間，先選一個最可能的原因驗證。

能收到復原通知，就先檢查通知中的線索

WordPress 在部分一般頁面載入的致命 PHP 錯誤情境，會寄送復原模式連結到管理員信箱。它不是所有 500、排程或伺服器故障都適用的入口。信件未出現也不能排除外掛問題，因為寄信流程可能尚未載入或投遞失敗。

核對信件中的網站與寄件情境後，透過連結登入並閱讀失敗元件提示。復原模式對有問題元件的暫停主要限於目前管理員工作階段，不代表一般訪客已恢復。若決定停用元件，那是網站設定變更，仍要檢查相關功能受到什麼影響。

用記錄檔辨認真正的失敗點

先從主機提供的 PHP 或網站伺服器錯誤記錄找同一時間的訊息。若需要 WordPress 偵錯，優先在可重現問題的測試副本啟用；WP_DEBUG_LOG 需要 WP_DEBUG 開啟才生效，預設可寫入內容目錄的 debug.log，也可指定其他有效路徑。

調整 wp-config.php 前先備份原檔，避免重複定義相同常數或誤用引號。正式環境若必須短暫蒐證，請熟悉主機設定的人協助關閉畫面錯誤顯示、限制記錄存取並在完成後復原。不要把含完整路徑、電子郵件或權杖的原始記錄貼到公開討論區。

看到某個外掛檔名是定位線索，還要讀取錯誤類型和相鄰呼叫資訊。過時功能提醒不一定是這次中斷原因；若 WordPress 記錄空白，可能是記錄未成功寫入或錯誤發生更早，應回查主機層記錄，不要因此宣告網站正常。

每次只驗證一個假設

若時間線與錯誤都指向剛更新的外掛，可先在副本停用該外掛，重做同一操作。後台進不去時，官方也提供透過檔案管理暫時改名外掛資料夾的方式。操作前記下原名稱與啟用清單，優先處理明確指向的元件；全部停用可能連帶關閉表單、付款與防護。

例如停用相簿外掛後，文章恢復，但詢問表單仍失敗，便不能把兩者當成同一問題結案。保留兩組重現結果，分別確認。若切換佈景才恢復，接著檢查相容性與自訂程式，而不是長期把網站留在未配置的預設版面。

還原上一版本前要確認官方提供的版本來源與資料格式相容性。有些更新會修改資料庫，單獨換回舊檔未必能回復。若需要整站還原，先處理備份後新增的詢問與訂單，不能用較舊資料直接覆蓋仍需保留的紀錄。

主機設定要按證據調整

記憶體耗盡訊息代表該次處理超過可用上限，但提高數值不是所有問題的解法。先記錄觸發動作、輸入大小與主機限制，再請服務商確認資源是否能調整，或請外掛作者檢查異常消耗。不要一次把記憶體、執行時間和 PHP 版本全改掉。

涉及 .htaccess 的建議須先確認主機是否使用並允許這類規則。請客服核對錯誤行與最近修改；若暫時移開檔案測試，要保存原件並注意重新導向及存取限制可能一起失效。使用其他伺服器配置的網站，不能照抄相同步驟。

提供客服的問題單可以包含精確時間、受影響網址、錯誤摘要、最近變更、已測試的方法與結果。帳號密碼與完整備份則使用服務商指定的安全管道。一次給出這些線索，比連續傳送同一張錯誤畫面更容易推進處理。

恢復畫面後還要完成一輪驗收

離開復原模式後，用未登入的瀏覽器再次測試原本出錯的路徑，並核對登入、文章儲存、表單送出及通知等真正需要的功能。表單顯示成功時，也要確認資料和信件是否到達，避免只修好了前半段。

最後記下確認原因、修改項目及回復方式，關閉臨時偵錯、清理不再需要的敏感記錄並恢復原有防護。保留一份去識別的故障摘要給未來維護者；若原因仍未確認，應寫成暫時恢復及待查事項，不把沒有再出現等同永久修復。

四個步驟依序為記錄故障、閱讀記錄、單項調整與功能驗收，提醒每一步保留回復方式。
網站重新顯示後，仍需測試原本失敗的操作。 · 圖片：Mokaair (© Mokaair)
依可觀察線索選擇下一步，500 本身不是原因診斷。
線索優先核對避免的做法
更新後特定功能失敗元件版本、相容性及相同操作一次停用所有功能後直接結案
記憶體耗盡觸發輸入、處理流程與主機上限只把上限無限調高
伺服器設定錯誤實際使用的設定檔及錯誤行套用別種伺服器的規則
沒有 WordPress 記錄記錄權限與主機錯誤記錄認定沒有任何錯誤

同主題延伸閱讀

  • 生活分享

    WordPress 側邊欄與小工具：安排資訊與固定區塊

    WordPress 側邊欄可以放搜尋、作者介紹與相關內容，但應先確認它對讀者是否有幫助。本文整理傳統小工具、區塊小工具及區塊佈景的差異，說明如何新增、排序、暫時移除與驗收，也比較一般排列、黏附與固定顯示的用途。透過桌面、手機和文字放大的檢查，避免資訊區塊遮住正文或表單，讓網站增加入口時仍維持清楚的閱讀順序。

  • 生活分享

    WordPress 備份怎麼做：檔案、資料庫與還原演練

    WordPress 備份不能只看成功訊息。本篇用檔案、資料庫與異地保存建立備份清單，說明 UpdraftPlus、WPvivid 的操作入口、還原限制及隔離演練，幫你確認網站資料真的拿得回來。也整理排程、保留版本、設定檔與驗收紀錄，讓個人網站或工作室有人能接手復原。

  • 生活分享

    WordPress 會員與角色：誰能看、誰能改、誰能管理

    WordPress 的管理員、編輯、作者與訂閱者分別能做什麼？本篇用小型團隊的投稿與會員閱讀需求，拆解角色、操作權限和內容可見性的差別，說明 User Role Editor 的設定方向，以及隱藏選單為何需要另外驗證實際存取，提供權限表、測試步驟和交接提醒，避免為了方便把所有人設為管理員。

  • 生活分享

    安裝 WordPress 主題與外掛：來源、更新與停用流程

    安裝 WordPress 佈景主題或外掛前，先確認要解決的問題、下載來源、版本相容性與回復方式。本文整理後台搜尋、官方 ZIP 上傳、啟用及驗收流程，並說明更新、停用和刪除各自可能影響什麼。適合需要自行維護網站的台灣使用者，用一份簡短紀錄管理新增功能與長期成本，避免重複安裝、忘記授權或在正式站一次更動太多項目。

引用本文的文章

最新旅遊情報攻略

資料來源

生活分享