WordPress建立數據庫連接報錯如何調試

“建立數據庫連接錯誤”無疑是WordPress用戶可能面臨的常見錯誤之一。 它與白屏死機（WSOD）密切相關。 此錯誤表明您的網站不再與您的 WordPress 數據庫交互或無法訪問。 結果，您的整個網站不可用。

此外，您應該立即解決此問題，因為它會影響您的銷售、流量和分析。

本文將解釋“Error Establishing a Database Connection”的含義，如何在 WordPress 中調試它，以及可能的原因。 然而，在我們開始解決這個問題的第一步之前，我們必須先了解這個數據庫錯誤的含義。

“建立數據庫連接時出錯”是什麼意思？

當 WordPress 無法連接到數據庫時，會顯示“Error Establishing a Database Connection”警告。

WordPress 最初是用 PHP 編寫的，並使用 MySQL 作為其數據庫系統。 當有人訪問您的站點時，某些 PHP 命令將從數據庫中檢索信息並將其顯示在訪問者的瀏覽器上。

由於瀏覽器中沒有可檢索和顯示的數據，WordPress“建立數據庫連接時出錯”通知將出現在空白頁面上。

幸運的是，只要您網站的緩存可用，此錯誤通知就不會出現在前端。 但是，此數據庫連接錯誤會阻止您訪問 WordPress 儀表板。 考慮到這一點，找出導致此錯誤的原因並修復它很重要。

此錯誤的最常見原因是什麼？

那麼，是什麼原因造成的呢？ 以下是一些常見原因。 別擔心； 我們將更詳細地介紹每個問題，以便您了解如何修復它們。 此問題通常會在 15 分鐘內得到解決。

• 最常見的錯誤是您的數據庫登錄憑據不正確。 您的 WordPress 站點使用不同的登錄名連接到其 MySQL 數據庫。
• 您的數據庫已損壞。 由於有太多帶有主題和插件的移動部件，並且用戶不斷地刪除和安裝它們，數據庫可能會損壞。 這可能是由於表格丟失或損壞，或者因為您不小心刪除了一些信息。
• 您的 WordPress 安裝可能包含損壞的文件。 這也可能是黑客造成的。
• 您的數據庫服務器出現問題。 Web 主機端可能會出現一些問題，例如流量激增導致數據庫溢出或由於並發連接過多而變得不可用。
• 流量增加。 根據您選擇的 Web 主機，您的服務器可能無法管理許多並發數據庫連接。 流量增加可能會導致數據庫出現暫時性問題。

如何調試“Error Establishing a Database Connection”？

在調試錯誤之前，我們建議對 WordPress 站點進行備份。 下面的許多建議都需要修改數據庫中的數據。 因此，您不想讓事情變得更糟。 無論您認為自己多麼精通技術，您都應該在嘗試修改 WordPress 網站之前對其進行備份。

要備份您的文件和數據庫，請使用流行的 WordPress 備份插件，例如 UpdraftPlus 或 BackupBuddy。

備份完成後，就該查看數據庫連接錯誤了。

1. 檢查您的 WordPress 數據庫憑據

WordPress 中數據庫連接錯誤的最常見原因是不正確的數據庫憑據。 如果您剛剛將 WordPress 站點轉移到新主機，則最有可能發生這種情況。

wp-config.php文件保存您的 WordPress 數據庫憑據。 它是 WordPress 配置文件，其中包含重要的 WordPress 設置，包括數據庫信息。

在 wp-config.php 文件中查找以下行。

// ** MySQL settings - You can get this info from your web host ** // /** The name of the database for WordPress */ define( 'DB_NAME', 'database_name_here' ); /** MySQL database username */ define( 'DB_USER', 'username_here' ); /** MySQL database password */ define( 'DB_PASSWORD', 'password_here' ); /** MySQL hostname */ define('DB_HOST', 'localhost');

您必須確保數據庫名稱、用戶名、密碼和主機都是正確的。

您可以從您的 WordPress 託管帳戶的儀表板確認此信息。

我們以 Bluehost 作為本文的示例，但其他主機控制面板的過程類似。

轉到您的託管帳戶並從數據庫部分選擇 MySQL 數據庫。

這會將您帶到託管儀表板中的數據庫管理頁面。 從這裡，您將看到您的數據庫名稱和用戶名。

在此之下，您將看到數據庫用戶和更改用戶密碼的鏈接。

確認您的數據庫名稱、用戶名和密碼後，您可以根據需要在 wp-config.php 文件中更新該信息。

然後，返回您的網站驗證數據庫連接錯誤是否已解決。

如果您仍然可以看到錯誤，則說明其他地方不正確。 繼續閱讀以獲取更多故障排除提示。

2.修復WordPress數據庫

損壞的數據庫是 WordPress 中“建立數據庫連接時出錯”的另一個原因。 這可能是由於經常安裝或刪除的插件或主題的數據故障導致的。

如果您的 WordPress 儀表板警告， “一個或多個數據庫表不可用。 數據庫可能需要修復，”您的數據庫已損壞。

幸運的是，您可以通過將以下代碼添加到您的 wp-config.php 文件來簡單地解決這個問題：

define('WP_ALLOW_REPAIR', true);

添加代碼後，在瀏覽器中轉到http://www.example.com/wp-admin/maint/repair.php 。

從這裡，您將看到兩個用於修復數據庫的選項； 選擇最能滿足您需求的那一款。

修復過程完成後，檢查您的 WordPress 站點，看看是否一切都恢復正常。 如果是這樣，請直接轉到您的 wp-config.php 文件並刪除該功能。 這避免了網站濫用，因為任何人都可以在不登錄的情況下查看維修頁面。

3.修復損壞的文件

除了損壞的數據庫之外，損壞的文件也可能是“建立數據庫連接時出錯”的原因。

文件損壞的原因之一是有缺陷的主題或插件。 分別檢查每一個將幫助您確定問題所在。 如果在激活新主題後出現錯誤，則您的主題可能是問題的根源。

要解決此問題，請從 WordPress 儀表板轉到外觀 » 主題，然後切換到新主題。

如果更改主題不能解決問題，則可能是由錯誤的插件引起的。 在這種情況下，請考慮停用所有插件，然後一次重新啟用它們以確定原因。

或者，您可以通過在主機控制面板中重命名插件文件夾來禁用所有 WordPress 插件。

通過這樣做，您的所有插件將立即被禁用。 如果重命名插件文件夾後錯誤消失，則表明其中一個插件是問題所在。

訪問站點後端后，將插件文件夾重命名為其原始名稱。 通過這樣做，所有的 WordPress 插件將保持不活動狀態，但您可以從管理區域一個一個地激活它們。

如果以上提示均無效，請嘗試將核心文件重新上傳到您的 WordPress 站點。 為此，請安裝新版本的 WordPress。

下載完成後，解壓縮包。 從文件夾中刪除wp-content 文件夾以及wp-config-sample.php文件。

刪除它們後，打開一個 FTP 程序並將剩餘的 WordPress 文件上傳到您的根文件夾。 現在應該可以安全地替換服務器上任何損壞的文件。

4.檢查您的數據庫服務器是否已關閉

當您的 MySQL 服務器關閉時，“建立數據庫連接時出錯”警告可能會顯示在您的 WordPress 網站上。 雖然此錯誤可能由多種因素引起，但通常是連接過多。

數據庫服務器一次只能連接特定數量的客戶端。

當它超過該限制時，它可能無法處理更多連接。 因此，我們建議您聯繫您的託管服務提供商以檢查您的 MySQL 服務器。

如果您在同一台服務器上託管多個站點，您還可以檢查這些站點上的 MySQL 服務器是否已關閉。 同時，如果你只託管一個網站，使用PHP連接MySQL，看看你的WordPress數據庫用戶是否有足夠的權限。

轉到您的主機控制面板並打開public_html文件夾。 創建一個新的 PHP 文件並為其命名。 在此示例中，我們將調用文件 dbconnection.php。

然後將以下代碼粘貼到其中：

 $link = mysqli_connect('localhost', 'username', 'password'); if (!$link) { die('Could not connect: ' . mysqli_error()); } echo 'Connected successfully'; mysqli_close($link);

請記住用您的憑據替換數據庫密碼和用戶名。 最後，將此文件保存到您的網站並使用網絡瀏覽器查看。

如果連接成功，則意味著您的用戶具有足夠的權限，並且其他原因導致了錯誤。

5. 檢查你的數據庫主機信息

如果您的數據庫名稱、用戶名和密碼正確，請仔細檢查您使用的數據庫主機信息是否正確。

大多數 WordPress 託管公司使用 localhost 作為您的數據庫主機。 但是，一些託管的 WordPress 託管服務提供商在不同的服務器上託管數據庫。 在這種情況下，您的數據庫主機信息將不是 localhost。

您必須聯繫您的 WordPress 託管公司以檢查您的數據庫主機詳細信息。

6.創建一個新的數據庫

如果以上方法均未顯示任何結果，則您的數據庫可能已損壞且無法再使用。 在這種情況下，您必須使用主機控制面板來設置新的 MySQL 數據庫和用戶。

創建新的 MySQL 數據庫後，恢復您的網站備份以避免丟失任何重要的網站數據。

結論

在 WordPress 站點上看到“Error Establishing a Database Connection”可能會令人沮喪。 該網站將無法加載，從而導致流量和客戶流失。

當 WordPress 網站無法創建與服務器的連接時，會發生此數據庫錯誤。 這可能是由不同的因素引起的，包括 wp-config.php 文件中不正確的數據庫登錄憑據、損壞的文件或服務器過載。

幸運的是，有幾種方法可以調試此錯誤：

• 檢查您的數據庫憑據——將 wp-config.php 文件中的數據庫憑據與 MySQL 數據庫中的數據庫憑據相匹配。
• 修復數據庫——通過添加 define('WP_ALLOW_REPAIR', true); wp-config.php 文件中的函數。
• 修復損壞的文件——通過您的 WordPress 儀表板停用損壞的主題或插件，或下載最新版本的 WordPress 並重新上傳您的核心文件。
• 檢查你的 MySQL 服務器——用 mysqli_connect 函數創建一個新文件，看看你的數據庫用戶是否有足夠的權限。
• 檢查數據庫主機信息——仔細檢查您使用的數據庫主機信息是否正確。
• 創建新數據庫——從頭開始創建新的 MySQL 數據庫，然後導入備份。

我們希望本文能幫助您調試 WordPress 中的“Error Establishing a Database Connection”。 確定此錯誤的可能原因，然後按照以下步驟進行修復。

您可能還想查看我們的以下文章：

• 如何修復 WordPress 白屏死機錯誤
• 增加 WordPress PHP 內存限制（4 種方法）
• 如何修復 WordPress 中 Facebook 不正確的縮略圖問題

最後，在 Twitter 和 Facebook 上關注我們，定期更新新文章。