WordPress建立資料庫連線時出錯（Error Establishing a Database Connection）終極解決方案

錯誤型別：: 資料庫錯誤

錯誤名稱：: 建立数据库连接时出错

英文名稱：: Error Establishing a Database Connection

錯誤描述：: 数据库损坏或者登录凭据不正确，损坏的WordPress文件，数据库服务器问题和流量激增都有可能导致此错误发生。

Error Establishing a Database Connection解決方案

“ 建立資料庫連線時出錯（Error Establishing a Database Connection） ”可能是WordPress使用者可能遇到的最常見和最可怕的錯誤之一。這絕對與死亡白屏（WSOD）息息相關。此錯誤意味著您的網站不再通訊或可以訪問WordPress資料庫，整個網站癱瘓。

對於這樣的錯誤，站長切勿掉以輕心的事情，應該立即嘗試解決此問題，直接影響流量，SEO等等。但不用擔心，今天我們將討論導致此錯誤的一些常見情況，以及對應的解決方案。

什麼是建立資料庫連線時出錯？
導致此錯誤的常見情況
如何修復“建立資料庫連線時出錯”

什麼是建立資料庫連線時出錯？

WordPress網站上的所有資訊，例如釋出資料，頁面資料，元資訊，外掛設定，登入資訊等，都儲存在MySQL資料庫中。唯一沒有儲存的資料是媒體內容，例如影象，以及主題/外掛/核心檔案，例如index.php，wp-login.php等。當有人訪問您的網站時，PHP會在頁面上執行程式碼並從資料庫中查詢資訊，然後將其顯示到訪客瀏覽器中。

如果由於某種原因這無法正常工作，則將出現建立資料庫連線時出錯，如下所示。整個頁面空白，因為連線無法正常工作，無法檢索任何資料以呈現頁面。這不僅破壞了網站的前端，而且導致無法訪問WordPress儀表板。

但是，訪客可能不會立即在前端看到此錯誤。那是因為站點快取還可供訪問，直到快取過期為止。

建立資料庫連線時出錯截圖

建立資料庫連線時出錯

當發生此錯誤時訪問者嘗試訪問您的站點時，它將在您的日誌中生成500 HTTP狀態程式碼。同樣的狀態碼會出現“內部伺服器錯誤”。這意味著伺服器出現問題，請求的資源未交付。當一切正常時，您的站點將生成200 HTTP狀態程式碼，這意味著一切正常。

導致此錯誤的常見情況

那麼究竟為什麼會發生這種情況呢？好吧，以下是一些常見的原因。不用擔心，我們將更深入地研究每一個問題，以便您知道如何解決它們。通常，您可以在15分鐘內解決此錯誤。

最常見的問題是資料庫登入憑據不正確。WordPress網站需要使用資料庫相關登入資訊來連線到其對應的MySQL資料庫。
資料庫已損壞。由於主題，外掛可安裝解除安裝如此之多，長年累月的不斷刪除和安裝，有時會導致資料庫損壞。這可能是由於表丟失或個別損壞，或者是某些資訊被意外刪除了。
WordPress安裝中可能存在損壞的檔案。這有時甚至可能由於黑客而發生。
資料庫伺服器問題。Web主機端可能有幾件事是錯誤的，例如由於流量峰值導致資料庫過載或由於太多併發連線而無響應。這在共享主機中很常見，因為它們為同一伺服器上的許多使用者使用相同的資源。
流量激增。根據您使用的 Web 主機，您的伺服器可能無法處理許多併發資料庫連線。流量的增加可能會導致資料庫出現臨時問題。

如何修復“建立資料庫連線時出錯”

在開始對錯誤進行故障排查之前，建議您首先進行資料庫備份，因為以下許多建議涉及運算元據庫中的資訊。無論你的技術水平如何，在嘗試修改WordPress網站資料庫之前，都應始終進行備份。

您可以使用WordPress備份外掛（例如VaultPress或WP Time Capsule）來備份檔案和資料庫。

如果是寶塔面板使用者，那就網站檔案及資料庫備份就很簡單了，進入寶塔控制面板，在左邊選單找到“計劃任務”，進入介面找到備份資料庫和備份網站，手動執行即可。

備份WordPress網站

當然你還可以通過SFTP等工具，進入伺服器執行手動備份網站檔案，及通過phpMyAdmin手動備份MySQL資料庫。備份成功後，就該開始對“建立資料庫連線時出錯”問題進行故障排除了。

參考閱讀：《使用BackWPup外掛備份WordPress教學》、《如何安全備份WordPress部落格網站資料？》

1.檢查資料庫登入憑據

首先要做的是檢查以確保WordPress配置檔案的資料庫登入憑據正確。這是迄今為止“建立資料庫連線時出錯”報錯的最常見原因，特別是在遷移網站到新的託管服務提供商之後。WordPress網站的連線詳細資訊儲存在wp-config.php檔案中，該檔案通常位於WordPress網站的根目錄下。

它包含四個重要資訊，這些資訊都必須正確才能成功進行連線資料庫。

資料庫名稱

// ** MySQL settings ** //

/** The name of the database for WordPress */

define('DB_NAME', 'xxxxxx');

// ** MySQL settings ** // /** The name of the database for WordPress */ define('DB_NAME', 'xxxxxx');

// ** MySQL settings ** // 
/** The name of the database for WordPress */ 
define('DB_NAME', 'xxxxxx');

資料庫使用者名稱

/** MySQL database username */

define('DB_USER', 'xxxxxx');

/** MySQL database username */ define('DB_USER', 'xxxxxx');

/** MySQL database username */ 
define('DB_USER', 'xxxxxx');

資料庫密碼

/** MySQL database password */

define('DB_PASSWORD', 'xxxxxxxxx');

/** MySQL database password */ define('DB_PASSWORD', 'xxxxxxxxx');

/** MySQL database password */ 
define('DB_PASSWORD', 'xxxxxxxxx');

主機名（伺服器）

/** MySQL hostname */

define('DB_HOST', 'localhost');

/** MySQL hostname */ define('DB_HOST', 'localhost');

/** MySQL hostname */ 
define('DB_HOST', 'localhost');

要訪問wp-config.php檔案，您可以通過SFTP連線到站點並瀏覽到站點的根目錄。或者，如果您使用的是寶塔，則可以進入寶塔控制面板單擊“檔案”，瀏覽到站點的根目錄，然後右鍵單擊以編輯檔案。

寶塔檔案管理

以下是開啟檔案後的示例。

wp-config.php檔案資料庫訪問憑證

現在，您需要對照當前值及伺服器資料庫真實值，以確保它們正確無誤。對於寶塔使用者，請按照以下說明進行操作。

檢查寶塔面板中的資料庫憑據

您需要登入寶塔面板，進入資料庫即可找到網站對應的資料庫，找到資料庫名、使用者名稱及密碼等資訊。

寶塔面板檢視資料庫賬號密碼

然後核對wp-config.php檔案的對應資訊，確保兩邊的資訊一致即可，非常方便。（或者這也就是國內眾多站長選擇使用寶塔面板的原因）

檢查cPanel面板中的資料庫憑據

如果你是使用cPanel管理主機，整個步驟稍微有點複雜。

首先要檢查的是資料庫名稱。為此，您需要進入cPanel控制面板登入phpMyAdmin 。

cPanel控制面板的phpMyAdmin

在左側選單找到你的網站對應的資料庫名稱。忽略“information_schema”資料庫，因為這是主機使用的資料庫。然後，將該名稱與wp-config.php檔案中的DB_NAME值進行比較。如果它們匹配，那麼這不是問題。如果它們不匹配，那麼您需要更新wp-config.php檔案。

cPanel 資料庫名稱

您還可以通過確保資料庫是否包含你網站的URL來驗證這是正確的資料庫。只需單擊資料庫，然後單擊wp_options表（出於安全目的，此名稱可能稍有不同，例如wpxx_options）。在表格的頂部，您將看到網站URL和名稱的值。如果這些與您當前站點匹配，說明這個是你的網站的資料庫。

在phpMyAdmin檢查網站URL

如果資料庫名稱正確，但是在建立資料庫連線時仍然出現錯誤，那你還需要檢查使用者名稱和密碼。為此，你需要在WordPress網站的根目錄中建立一個新的PHP檔案（隨意命名，例如checkdb.php），並輸入以下程式碼，需使用wp-config.php檔案中的值替換為db_user和db_password的值。

<?php

$test = mysqli_connect('localhost', 'db_user', 'db_password');

if (!$test) {

die('MySQL Error: ' . mysqli_error());

}

echo 'Database connection is working properly!';

mysqli_close($testConnection);

<?php $test = mysqli_connect('localhost', 'db_user', 'db_password'); if (!$test) { die('MySQL Error: ' . mysqli_error()); } echo 'Database connection is working properly!'; mysqli_close($testConnection);

<?php
$test = mysqli_connect('localhost', 'db_user', 'db_password');
if (!$test) {
die('MySQL Error: ' . mysqli_error());
}
echo 'Database connection is working properly!';
mysqli_close($testConnection);

瀏覽器訪問https://yourdomain.com/checkdb.php。如果收到“MySQL Error: Access denied（MySQL錯誤：訪問被拒絕）”，則說明您的使用者名稱或密碼錯誤，您將需要繼續執行下一步以重置憑據。

MySQL錯誤：訪問被拒絕

但如果是“Database connection is working properly.（資料庫連線正常工作）”，則說明資料庫使用者名稱和密碼正確。完成測試後，請確保刪除此檔案。

資料庫連線正常工作

如果確定資料庫使用者名稱和密碼錯誤，接下來您需要重置使用者名稱和密碼。在cPanel中，點選“MySQL資料庫”。

cPanel 控制面板之MySQL資料庫

向下滾動並建立一個新的MySQL使用者。嘗試選擇唯一的使用者名稱和密碼（可以使用提供的密碼生成器工具生成高強度密碼），以免輕易被猜中。然後點選“Create User”。或者，您也可以在此介面上更改當前資料庫使用者的密碼。

建立MySQL使用者

然後向下滾動並將新使用者新增到資料庫中。下一個介面將詢問您要分配的特權，選擇“All Privileges（所有許可權）”。

使用cPanel新增資料庫使用者

然後使用這些新憑據並更新至wp-config.php檔案（更新DB_USER和DB_PASSWORD值）。到此，你也可以使用前面提到的測試檔案驗證資料庫憑證資訊是否正確。但如果這未能解決問題，可能是主機名（DB_HOST）錯誤。某些主機使用不同的值，你可以參閱一些常見資料庫主機值列表，或者檢視主機相關文件及聯絡主機提供商提供。有些人可能還會使用127.0.0.1而不是localhost。

如果您已完成上述所有操作，但仍是“建立資料庫連線時出錯”，繼續往下看。

2. 修復損壞的資料庫

在某些情況下，可能是資料庫已損壞。有時（儘管不是很經常）會發生這種情況，因為隨著時間的推移，新外掛和主題會不斷新增/刪除數百張資料表。如果您嘗試登入WordPress網站的儀表板並收到以下錯誤，則表明您的資料庫已損壞：“一個或多個資料庫表不可用。資料庫可能需要修復。” 重要的是要注意，您可能只會在訪問WordPress管理後臺才看到此錯誤，而在前端僅看到建立資料庫連線錯誤提示。

WordPress實際上提供可以啟動的資料庫修復模式。只需將以下內容新增到wp-config.php檔案的底部。

define('WP_ALLOW_REPAIR', true);