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

如果您已經建立了一個本地環境（使用MAMP）開發和測試您的WordPress網站，那麼在某些時候，您可能會收到“建立資料庫連線時出錯Error establishing a database connection”訊息。獲取此通知可能令人費解，但當您知道在哪裡檢視時，解決方案相當簡單。

在本文中，我們將解釋這個錯誤是什麼以及它發生的原因。然後我們將引導您完成如何識別和修復它以恢復您的WordPress站點和資料庫之間的連線。

1. MAMP“建立資料庫連線時出錯”是什麼
2. MAMP中“建立資料庫連線錯誤”的常見原因
3. 如何修復MAMP“建立資料庫連線時出錯”

MAMP“建立資料庫連線時出錯”是什麼

WordPress是一個強大的內容管理系統 (CMS)，它使您能夠建立動態網頁，而不僅僅是靜態HTML站點。WordPress將網站內容儲存在資料庫中，頁面上的程式碼在需要時呼叫該資料庫。因此，站點檔案和資料庫之間的通訊至關重要。

MAMP是一個免費工具，您可以下載（提供高階選項）以在本地計算機而不是Web伺服器上執行您的網站。它的名稱是它包含的內容的首字母縮寫詞——macOS、Apache、MySQL和執行WordPress的PHP——以及其他可選工具。在本地安裝WordPress 使您能夠在開發期間測試站點。

當嘗試使用MAMP建立與資料庫的連線時發生錯誤，通常是因為wp-config.php檔案具有不正確的資料庫憑據。更具體地說，MAMP中的資料庫連線錯誤表示wp-config.php檔案與資料庫 之間的變數不正確或不匹配。幾個不正確的設定可能會導致此問題。讓我們定義每一個。

MAMP中“建立資料庫連線錯誤”的常見原因

預設情況下，將WordPress站點連線到資料庫的wp-config.php檔案中的關鍵設定是：

• 資料庫名稱：“wordpress”（除非您在安裝期間重新命名）
• 資料庫使用者：“root”
• 資料庫密碼：“root”
• 資料庫主機：“localhost”

錯誤配置的伺服器埠也可能導致連線錯誤。請記住這一點，以防您最初的努力無法清除錯誤。您可能需要對伺服器埠進行一些額外的故障排除。

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

那麼，遇到這個錯誤怎麼辦呢？您可以使用以下步驟來定位、驗證和更正（如有必要）配置設定，以在WordPress和MAMP中的資料庫之間重新建立連線。

第 1 步：找到您的資料庫憑證

您可能會收到一條錯誤訊息，因為您的wp-config.php檔案中的設定有誤。該檔案是您應該首先檢查的地方，因為它通常是錯誤源。這也是一個簡單的修復，可以快速解決問題。

您可以在WordPress站點的主目錄中找到wp-config.php檔案。對於Windows使用者，該檔案的預設位置 在您計算機上的C:/MAMP/htdocs/wordpress/資料夾中。對於Mac使用者，它位於/Applications/MAMP/htdocs/wordpress/ 資料夾中。

您可以通過檢查其設定來驗證WordPress MAMP安裝的位置。為此，請開啟MAMP應用程式：

MAMP應用程式

您的安裝資料夾列在Document Root設定中。

第 2 步：驗證您的資料庫登入憑據

在本地WordPress安裝中找到wp-config.php檔案後，開啟它。接下來，向下滾動，直到找到資料庫憑據：

wp-config.php檔案中列出的WordPress資料庫憑據

將有一組定義：

• ‘DB_NAME’
• ‘DB_USER’
• ‘DB_PASSWORD’
• ‘DB_HOST’

驗證“DB_NAME”值是否與您的資料庫名稱匹配。預設情況下它可能是“wordpress”，如上圖所示。

請注意，如果您從“wordpress”更改了預設名稱並且您不記得您重新命名資料庫的內容，那麼您可以採用另一種方法。在MAMP中，選擇開啟起始頁 (Windows) 或WebStart  (Mac)。當瀏覽器開啟到MAMP起始頁時，導航到Tools選單下的phpMyAdmin ：

MAMP應用程式開始選單

資料庫列表將顯示在phpMyAdmin的左側列中。找到您的WordPress資料庫的名稱（在下圖中顯示為預設的“wordpress”）：

phpMyAdmin設定螢幕

驗證（或更正）資料庫名稱後，您可以向下移動wp-config.php檔案中的定義列表，以驗證其餘資料庫設定是否正確。如果您更改了使用者名稱或密碼，您可以直接在wp-config.php檔案中進行更正。

預設情況下，“DB_USER”和“DB_PASSWORD”都應設定為“root”。後一個欄位由MAMP配置。常規MySQL安裝會將密碼欄位留空（“”），這就是為什麼一些指南會建議將其恢復為該值的原因。

“DB_HOST”應設定為“localhost”。或者，您可能需要使用MAMP指定的埠號將“DB_HOST”配置為這些選項之一：

• ‘DB_HOST’, ‘localhost:8889’
• ‘DB_HOST’、’127.0.0.1:8889’

要檢視MAMP的指定埠設定，您可以參考步驟3。如果您更正了上述任何設定，請將您的更改儲存在wp-config.php檔案中，然後再次嘗試通過MAMP訪問您的網站。

第 3 步：檢查您的埠設定（如有必要）

如果您仍然收到連線錯誤，則需要檢查MAMP首選項設定中的Server Port。在Windows中，MAMP預設使用埠80進行Apache Port和Nginx Port設定。MySQL Port設定為3306。

MAMP埠設定螢幕

在Mac上，MAMP預設使用埠8888、8889和7888用於Apache埠/ Nginx埠/ MySQL埠設定，以及80和3306用於 Web和MySQL  MAMP預設設定。

MAMP埠設定

您應該在MAMP應用程式設定中驗證這些值是否正確（如上圖所示）。而已！您應該不再在本地WordPress安裝中看到“建立資料庫連線時出錯” 。

小結

當您在MAMP中遇到連線錯誤時，通常是由於WordPress安裝中的wp-config.php檔案與MySQL資料庫不匹配。通過檢視WordPress設定中的資訊並將其與資料庫憑據進行比較，您可以找到問題並更正設定以重新建立連線。

在本文中，我們討論了在使用MAMP時可能會看到“建立資料庫連線時出錯”訊息的常見原因。通常，解決此問題的最簡單方法是檢查您的wp-config.php檔案以確保您的資料庫名稱、使用者名稱、密碼以及主機和埠設定正確。