如何修復“建立數據庫連接時出錯”

哦，可怕的“建立數據庫連接時出錯”，dum，dum，dum（想像不祥的音樂播放）。 如果您是經驗豐富的 WordPress 設計師或開發人員，您很可能會立即著手修復此錯誤。 但是對於那些不熟悉 WordPress 的人來說，這可能是一個可怕的錯誤消息。

當您嘗試手動安裝 WordPress 時，您可能會看到此錯誤，或者當您嘗試打開您的網站或本地開發環境時，您會在瀏覽器的白屏上看到這個錯誤的大號黑色字體。 後者是這個錯誤最可怕的版本，因為它通常會讓你措手不及。

當然，任何好的託管 WordPress 主機都應該為您配置一切，並確保這些錯誤永遠不會出現。 但是，如果您使用的是讓您自己安裝和管理 WordPress 的 WordPress 主機，或者如果您在本地計算機上進行開發，您可能會遇到這個問題。

在運行 WordPress 所需的所有 WordPress PHP 文件中， wp-config.php是最重要的，因為沒有該文件，您的站點將無法連接到其數據庫，並且您的站點將無法運行。 此文件用於定義數據庫連接信息，例如數據庫名稱、用戶名、密碼和主機。 在像 Flywheel 這樣的主機上，您實際上無法編輯此文件，因為它是為您配置的。 如果您使用託管主機，則可以安全地跳過下一個原因。

此錯誤的最常見原因

出現臭名昭著的“建立數據庫連接時出錯”的最常見原因是wp-config.php中的數據庫連接設置不正確。 從舊託管公司遷移站點時，您必須確保更新wp-config.php文件中的數據庫名稱、數據庫用戶名和數據庫密碼，以反映新主機上的新數據庫。

不正確地移動您的 WordPress 網站

我見過的一個常見問題是，有人將他們的 WordPress 文件移動到新的託管公司，然後將域名指向新的主機，但他們沒有移動他們的數據庫。

讓您的網站快速發展：第 2 部分

上週，我談到瞭如何以前端性能為重點來加快您的網站速度。 雖然這對加快您的網站速度非常有幫助，但請不要忘記 - 還有後面...

當您轉到 URL 時，該站點仍會顯示，並且該站點仍將運行。 這裡的問題是，當您最終取消舊主機時，網站將關閉，因為您正在連接到舊主機帳戶上的數據庫，從而產生“建立數據庫連接時出錯”錯誤消息。

最佳做法是將所有內容移至您的新託管公司並更新您的wp-config.php文件以反映新數據庫。 這樣您就可以放心地取消您的舊主機帳戶，而不會丟失任何數據並看到可怕的“建立數據庫連接時出錯”錯誤。

如果您在飛輪上，他們只會為您移動所有東西，並確保您啟動並運行，無需弄清楚這些配置中的任何一個。

您的wp-config.php文件是您嘗試解決此問題時應該首先開始的地方。 如果您確認您的連接信息確實正確，請繼續進行下面列出的這些其他修復。

發生此錯誤的原因可能有多種，我將帶您了解一些其他情況。 不用擔心 - 您無需成為開發人員嚮導即可修復此錯誤。

在嘗試以下任何這些修復之前，請確保創建數據庫的備份。 您可以通過您的主機控制面板轉到 phpMyAdmin 然後導出 SQL 文件來執行此操作。

讓我們潛入好嗎？

原因 1. 更改數據庫密碼時忘記更新 wp-config.php 文件

更新數據庫密碼以使您的數據庫更安全是一件非常好的事情。 強密碼是最好的密碼。 請記住，當您在主機控制面板中更改數據庫的密碼時，您還需要在wp-config.php文件中更改密碼。

好消息是，這很容易解決。 您所要做的就是打開您的wp-config.php文件並添加新密碼。

下載您的wp-config.php文件，打開文本編輯器，然後編輯以下行：

define('DB_PASSWORD', 'password-goes-here');

添加新密碼，保存wp-config.php文件，然後通過 FTP 上傳。 刷新您的網站，看看您的網站是否回來了。 如果是這樣，你就完成了。 恭喜——你贏得了所有的互聯網積分！

注意：確保在密碼周圍留下單引號，並且單引號和密碼之間也不應有空格。

很容易對吧？

本質上，您所做的是確保更新您的數據庫連接信息以反映新的數據庫密碼。

再一次，如果您使用的是像 Flywheel 這樣的主機，則此步驟不適用於您，您可以安全地繼續前進！

原因 2. 在著名的 WordPress “5 分鐘安裝”過程中，您輸入了錯誤的數據庫信息

在線工作時，拼寫錯誤確實是我們生存的禍根。 一個小小的錯字可能會導致網站崩潰，在這種情況下，錯誤的下劃線或忘記數據庫名稱、用戶名或密碼中的字母或數字也會產生相同的崩潰效果。

如今，大多數 WordPress 安裝都是通過您的主機控制面板使用嚮導來處理的，或者在託管 WordPress 上完全為您完成。 但是有些人確實喜歡手動安裝。 我聽說手動安裝仍然是一回事。

如果您選擇通過手動創建數據庫並通過 FTP 手動上傳 WordPress 軟件的方式以 Ye Olde Fashioned 方式安裝 WordPress，則需要確保在創建數據庫時保存數據庫用戶信息。 這是複制和粘貼真正派上用場的地方。

但是，請確保在復制此信息時，您只複製您需要的文本。 您知道在數據庫名稱、用戶名或密碼之後復制一個額外的空格會被讀取為字符嗎？ 當安裝程序嘗試連接到您的數據庫時，這個額外的空白字符會給您帶來錯誤。

此外，請確保您在安裝過程中在正確的字段中輸入信息。 我實際上有一次腦子放屁，並意識到我在錯誤的字段中輸入了數據庫名稱。 修復後，安裝順利進行！

原因 3. 將 WordPress 網站移動到新主機時，DB_HOST 可能是該主機獨有的

即使您更新了wp-config.php文件以反映新託管公司的新數據庫連接信息，您也可能必須更改DB_HOST字段。

這個問題比較少見，但確實會發生。 一些託管公司在wp-config中定義DB_Host參數時使用自己的唯一值，但情況並非總是如此。 其他主機實際上定義了 MySQL 數據庫服務器的 URL，並且需要反映為DB_HOST的值。 一些用戶也成功地使用了他們的主機 IP 地址來代替 MySQL URL 或 localhost，所以你也可以嘗試一下。

如果您在飛輪上，這會自動為您處理，因此您完全不必擔心。

原因 4. 您的數據庫已損壞

此錯誤與“建立數據庫連接時出錯”不同，但略有相關。 有時您網站的前端工作正常，但您在後端收到諸如“一個或多個數據庫表不可用，數據庫可能需要修復”之類的錯誤。 這意味著您應該修復數據庫。

這是此錯誤的修復：

打開您的wp-config.php文件並轉到定義數據庫名稱、用戶名、密碼和主機的部分。 在主機下定義以下內容：

define('WP_ALLOW_REPAIR', true);

然後保存你的wp-config.php文件，通過 FTP 上傳，然後轉到這個 URL：

這將拉出一個包含兩個選項的頁面。 選項一是顯示“修復數據庫”的按鈕，第二個選項是顯示“修復和優化數據庫”的按鈕

在執行此步驟之前，我必須重申備份數據庫的重要性。 即使您無法連接並不意味著您不應該有備份。

單擊“修復數據庫”選項，修復過程完成後打開一個新選項卡並轉到您的 URL，查看“建立數據庫連接時出錯”消息是否消失以及您的站點是否恢復正常。

如果此修復不起作用，並且上述修復不起作用，那麼您應該知道最後一個原因。

大多數託管主機每天都會為您備份您的數據，因此如果發生這種不太好的情況，有時從昨天的備份中恢復並繼續移動會更容易。

原因5. MySQL數據庫服務器宕機。

對於將共享主機推向極限的人來說，這往往會發生。 如果您的網站獲得大量流量，這可能會使數據庫服務器不堪重負。 向您致敬，因為您的網站獲得了所有甜蜜的流量，但是如果您收到“建立數據庫連接時出錯”消息並且您已經嘗試了其他修復，您可能需要升級。

在共享主機上，可以將大量網站塞進同一台服務器上。 如果一個人流量很大，或者只是一個嘈雜的鄰居，那麼它可能會給其他站點帶來巨大的問題。 在像 Flywheel 這樣的託管主機上，每個站點都有自己的服務器，所以這個問題很容易解決。

但是在直接進行託管升級之前，您應該致電您的託管公司並要求他們檢查數據庫服務器的狀態。 也許存在技術問題，或者您的託管公司向您發送了一封有關定期服務器維護的電子郵件，而您錯過了該電子郵件。 雖然您不太可能看到因服務器維護而導致的“建立數據庫連接時出錯”消息，但我在我的職業生涯中見過一次，無論哪種方式，都值得一通電話了解一下。

與您的託管公司交談並解釋您已經嘗試了這些不同的修復方法但無濟於事，並要求他們進行調查。 如果他們告訴您您的網站在服務器上產生了相當大的負載並建議進行主機升級，那麼恭喜您真棒！ 請記住，這些升級意味著您的網站正在發揮作用！

總結

正如您所看到的，修復“錯誤建立數據庫連接”錯誤並不像您想像的那麼可怕。 只需進行一點盡職調查即可檢查您是否在wp-config.php文件中定義了正確的數據庫設置。 在某些情況下，需要進行更深入的挖掘才能解決問題。 歸根結底，您的託管公司會為您提供支持。

了解有關飛輪的更多信息

無論您的工作環境如何，Flywheel 強大的 WordPress 平台都可以消除託管的所有麻煩，簡化您的流程，並讓您重新開始做最好的工作。

在這裡了解更多。