遇到PDO與MySQL連接錯誤時該如何解決？詳細錯誤及解決方法解析

在使用PHP的PDO（PHP Data Objects）連接MySQL數據庫時，經常會遇到各種連接錯誤。這類錯誤可能來源於配置問題、權限問題、網絡問題或PHP擴展問題。本文將詳細解析常見錯誤類型及對應的解決方案。

一、常見PDO連接錯誤及含義

• SQLSTATE[HY000] [1045] Access denied for user:用戶名或密碼錯誤。
• SQLSTATE[HY000] [2002] Connection refused:無法連接到數據庫服務器，可能是主機或端口錯誤。
• SQLSTATE[HY000] [1049] Unknown database:指定的數據庫不存在。
• SQLSTATE[HY000]: General error:一般性錯誤，可能是網絡或配置問題。

二、排查與解決方法

1. 檢查數據庫用戶名和密碼

確保在創建PDO實例時提供的用戶名和密碼正確無誤：

try {
    \$pdo = new PDO('mysql:host=localhost;dbname=testdb', 'root', 'password');
} catch (PDOException \$e) {
    echo '連接失敗: ' . \$e->getMessage();
}

如果出現1045錯誤，首先確認用戶權限是否正確，且該用戶允許從你的PHP服務器主機訪問數據庫。

2. 檢查主機和端口

確保使用正確的MySQL主機地址和端口，默認端口是3306。例如：

\$pdo = new PDO('mysql:host=127.0.0.1;port=3306;dbname=testdb', 'root', 'password');

如果MySQL服務在遠程服務器，確保網絡通暢並且防火牆允許3306端口訪問。

3. 確認數據庫存在

如果出現1049錯誤，請檢查數據庫名稱拼寫是否正確，或使用phpMyAdmin/命令行確認數據庫已創建。

4. 檢查PDO擴展

確保PHP已啟用PDO及PDO_MYSQL擴展：

php -m | grep PDO

如果未安裝，請在php.ini啟用或通過包管理器安裝對應擴展。

5. 設置字符集

連接時指定字符集可避免編碼相關錯誤：

\$pdo = new PDO('mysql:host=localhost;dbname=testdb;charset=utf8mb4', 'root', 'password');

6. 捕獲並輸出詳細錯誤

啟用異常模式，可以獲取更詳細的錯誤信息，便於調試：

\$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

三、總結

PDO與MySQL連接錯誤大多可通過以下步驟解決：

1. 確認用戶名和密碼正確且有權限。
2. 檢查主機地址和端口。
3. 確保數據庫存在。
4. 檢查PHP是否啟用PDO擴展。
5. 設置正確字符集。
6. 啟用異常模式捕獲錯誤。

通過以上方法，一般可以快速定位並解決PDO連接MySQL時出現的問題。