先做這件事
WordPress 500 錯誤：不要在沒有備份時連續試錯
500 是伺服器端通用錯誤，瀏覽器畫面通常不足以判斷。必須以發生時間對照 PHP、Web server 與 WordPress 日誌。
本文聚焦「先取得同時間伺服器錯誤，再分 PHP、資源、權限與重寫規則。」。對應的使用情境是：網站回傳 500，希望由低風險到高風險定位問題。。排查時請保存每一步的時間、畫面與日誌差異，才能把同時發生但無關的變更排除。
排查原則：先保存錯誤與現況，再從低風險、可回復的檢查開始；一次只改一個變因。
問題症狀
- 首頁或特定操作回傳 500
- 更新外掛後整站失效
- REST API 或 admin-ajax.php 回 500
把「整站、單頁、單一帳號、特定裝置」分開測試。受影響範圍越清楚，越能避免不必要地停用正常元件。
可能原因
- 01PHP 致命錯誤或不相容語法。需要用錯誤日誌、Network 或隔離測試確認，不應只因時間接近就下結論。
- 02記憶體／執行時間不足。需要用錯誤日誌、Network 或隔離測試確認，不應只因時間接近就下結論。
- 03.htaccess 或 Web server 規則錯誤。需要用錯誤日誌、Network 或隔離測試確認，不應只因時間接近就下結論。
修改前備份
先建立檔案與資料庫完整備份，下載到站外位置並確認可以讀取；另保存外掛、主題、PHP 版本與目前錯誤畫面。
若網站仍持續接收表單或訂單，先記錄備份時間與之後的新資料；整庫還原可能覆蓋這段期間的內容。
由低風險到高風險的排查順序
-
1. 記錄失敗 URL、時間與操作
這一步保持唯讀或可快速回復，先蒐集證據再改設定。 -
2. 查看同時間 PHP 與 Web server 日誌
這一步保持唯讀或可快速回復，先蒐集證據再改設定。 -
3. 檢查磁碟空間與 PHP 資源
每完成一步就重測同一個最小重現，確認問題是否改變。 -
4. 在測試站隔離最近變更
每完成一步就重測同一個最小重現，確認問題是否改變。 -
5. 必要時重建固定網址規則並比較差異
只把已在測試環境通過的最小變更套用到正式站，並立刻跑回歸測試。
每個變更都記錄檔案、設定、時間、執行者與預期結果；實際結果不同時立即回退，不把未知狀態留到下一步。
如何確認修復成功
受影響 URL 回 200，REST 與後台操作恢復，錯誤日誌不再出現同一堆疊。
- 以原本的最小重現步驟再次測試。
- 檢查首頁、登入、REST API、表單與網站最重要的交易流程。
- 查看 PHP error log、瀏覽器 Console 與 Network 是否新增錯誤。
- 以 390px 手機寬度確認沒有版面級橫向溢位。
把症狀與證據對成一條排查路徑
| 目前看到的症狀 | 先驗證的原因 | 最小安全動作 |
|---|---|---|
| 首頁或特定操作回傳 500 | PHP 致命錯誤或不相容語法 | 記錄失敗 URL、時間與操作 |
| 更新外掛後整站失效 | 記憶體／執行時間不足 | 查看同時間 PHP 與 Web server 日誌 |
| REST API 或 admin-ajax.php 回 500 | .htaccess 或 Web server 規則錯誤 | 檢查磁碟空間與 PHP 資源 |
這張表不是用來直接判定根因，而是把「看到什麼、要查什麼、哪個動作可回復」放在同一列。若第一列的證據不成立，就不要跳到高風險修改。
如何還原
還原修改前的 .htaccess、外掛或主題版本；不要用空白檔覆蓋而失去原規則。
保留失敗版本與日誌供比較，不要在回退時刪除所有證據；但任何憑證與個資必須安全遮蔽。
何時應停止自行操作
若沒有可還原備份、錯誤影響付款或個資、發現惡意程式，或需要直接修改資料庫但不理解關聯，應停止自行操作並尋求專業協助。
停止不是放棄，而是避免把可復原的錯誤變成停機、資料損失或資安事件。準備好時間線、備份、錯誤日誌與已嘗試步驟，能顯著縮短專業人員的診斷時間。
常見問題
可以直接在正式站測試嗎？
不建議。先備份並在測試環境重現，正式站只套用已驗證的最小變更。
需要關閉所有外掛嗎？
不應在沒有計畫時一次關閉。先保存清單，再用隔離或健康檢查方式逐步排除。
修好後要做什麼？
清除必要快取、重測主要流程、保存變更紀錄並確認監控沒有新錯誤。
官方文件與查核來源
以下文件用於核對 WordPress、WooCommerce、PHP 或資料庫行為。第三方外掛與主機設定仍需查閱該產品當前版本的正式文件。