MySQL 連線主機名 localhost vs 127.0.0.1 差異深度解析

核心差異：連線協議決定主機名來源

MySQL 客戶端連線時，是否指定 -h 參數決定連線協議，進而決定伺服器端看到的來源主機名：

• 無 -h 參數（或 -h localhost）→ Unix Socket 連線 → 伺服器端來源主機名為 localhost
• 指定 -h 127.0.0.1 → TCP/IP 連線 → 伺服器端來源主機名為 127.0.0.1

權限表匹配邏輯

MySQL 權限表 mysql.user 中 Host 欄位存儲允許連線的主機名。連線建立時，伺服器以「來源主機名」匹配 Host 欄位：

• Socket 連線 → 匹配 Host='localhost' 的帳號
• TCP/IP 連線 → 匹配 Host='127.0.0.1' 或 Host='%' 的帳號

常見坑點：僅建立 'root'@'localhost' 帳號，卻用 mysql -h 127.0.0.1 -u root -p 連線 → 拒絕存取（找不到匹配帳號）。

skip_name_resolve 參數的影響

skip_name_resolve=ON 可避免 DNS 解析延遲，但權限表必須使用 IP 或 %，不再支援主機名。

實務最佳實踐

1. 建立帳號時同時授權 localhost 與 127.0.0.1：

   CREATE USER 'app'@'localhost' IDENTIFIED BY 'pwd';
   CREATE USER 'app'@'127.0.0.1' IDENTIFIED BY 'pwd';
   GRANT ALL ON mydb.* TO 'app'@'localhost', 'app'@'127.0.0.1';

2. 或使用萬用字元（需評估安全性）：

   CREATE USER 'app'@'%' IDENTIFIED BY 'pwd';

3. 生產環境建議開啟 skip_name_resolve=ON，權限表統一用 IP，消除 DNS 依賴與解析延遲。
4. 連線字串明確指定協議：PHP PDO 使用 host=127.0.0.1 強制 TCP/IP，避免 Socket 檔案權限/路徑問題。

驗證指令

-- 查看當前連線的實際帳號
SELECT CURRENT_USER();

-- 查看權限表內容
SELECT User, Host FROM mysql.user WHERE User='root';

-- 測試兩種連線方式
mysql -u root -p                    # Socket → localhost
mysql -h 127.0.0.1 -u root -p       # TCP/IP → 127.0.0.1

總結

localhost 與 127.0.0.1 在 MySQL 中不是同義詞，分別代表 Unix Socket 與 TCP/IP 兩種截然不同的連線協議。理解此機制、正確配置權限帳號、善用 skip_name_resolve，是避免「明明密碼正確卻連不上」經典問題的關鍵。