Error Establishing a Database Connection 排查教學

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

Error Establishing a Database Connection 表示 WordPress 在產生頁面時無法連上資料庫。常見原因是資料庫服務中斷、主機資源不足，或 wp-config.php 的名稱、帳號、密碼、主機設定錯誤。先判斷影響範圍，再動設定或執行修復。

先判斷是全站還是單一環境

1. 用無痕視窗開首頁、後台與一篇文章，記下錯誤時間。
2. 查看主機狀態頁、資源用量與資料庫服務是否正在維護。
3. 若剛搬站或改密碼，優先核對設定；若無人改動卻突然全站故障，先找主機商確認服務。
4. 在修改前備份 wp-config.php 與資料庫，避免把暫時性故障變成永久設定錯誤。

若畫面不是資料庫連線錯誤，而是一般伺服器例外，可先看 500 Internal Server Error 排查；服務暫時超載或維護則參考 503 Service Unavailable 處理。

核對 wp-config.php 四項設定

從主機控制台取得實際資料庫資訊，逐一比對 DB_NAME、DB_USER、DB_PASSWORD 與 DB_HOST。不要把密碼貼到公開工單、截圖或聊天群，也不要直接在正式站反覆猜測。搬站後最容易忽略的是資料庫主機並非固定使用 localhost。

何時使用 WordPress 資料庫修復

WordPress 官方常見錯誤文件說明，可暫時在設定檔啟用 WP_ALLOW_REPAIR 進入修復頁。不過該頁啟用後不要求登入，因此只應在確認資料表損壞時短暫使用，完成後立刻移除設定並再次測試前台與後台。

• 先做可還原備份，再執行 Repair Database。
• 不要把修復模式當作主機中斷或密碼錯誤的通用解法。
• 完成後移除 WP_ALLOW_REPAIR，確認修復頁不能再公開進入。
• 查看 PHP、Web Server 與資料庫日誌，找出是否有容量或資源問題。

修好後如何避免再發生

設定網站與資料庫可用性監控、磁碟容量警示與定期還原演練；修改資料庫密碼或搬站時，把應用程式設定與驗證列進同一份變更清單。若日誌顯示異常登入或檔案被改動，應依入侵事件處理，而不是只把錯誤頁消除。