localhost 與 127.0.0.1 在 MySQL 連線中**代表完全不同的傳輸協議與權限匹配規則**,是導致「同機器能連、遠程不能連」或「PHP 連不上、命令列能連」的高頻根因。本文深度解析協議差異、權限表匹配邏輯、實戰排查案例與最佳實踐配置。
| 維度 | localhost | 127.0.0.1 |
|---|---|---|
| 傳輸協議 | Unix Domain Socket (Linux) / Named Pipe / Shared Memory (Windows) | TCP/IP (Loopback) |
| MySQL 權限表匹配 Host | 'localhost' | '127.0.0.1' 或 '%' |
| Socket 檔案位置 | my.cnf [mysqld] socket=/var/lib/mysql/mysql.sock | 不使用 Socket |
| 端口 | 不使用 3306 | 使用 3306 (或 port 設定) |
| 網路棧開銷 | 極低 (內核拷貝) | 較高 (TCP 協議棧) |
| 跨容器/網路命名空間 | **不通** (各自獨立 filesystem) | **可通** (網路層面) |
mysql> SELECT User, Host FROM mysql.user WHERE User='root';
+------+-------------+
| User | Host |
+------+-------------+
| root | localhost |
| root | 127.0.0.1 |
| root | % |
+------+-------------+
mysql -h localhost → 匹配 root@'localhost'。mysql -h 127.0.0.1 → 匹配 root@'127.0.0.1' 或 root@'%'。root@'localhost',用 127.0.0.1 會報 Access denied。mysql -u root -p ✅ 成功mysqli_connect('localhost', ...) ❌ Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock'localhost → 走 Unix Socket。socket=/tmp/mysql.sock,但 PHP 預設尋找 /var/lib/mysql/mysql.sock(或編譯時指定路徑)。$host = '127.0.0.1'; → 強制走 TCP,跨平台一致、無 Socket 路徑問題、支援容器化。my.cnf 同時在 [mysqld]、[client]、[mysql] 設定 socket=/var/lib/mysql/mysql.sock → 重啟 MySQL。ln -s /tmp/mysql.sock /var/lib/mysql/mysql.sock
# my.cnf
[client]
protocol = tcp
# 或
[mysql]
protocol = tcp
客戶端讀取此配置後,localhost 也會走 TCP 連線,繞過 Socket 問題。
[mysqld] enable-named-pipe / shared-memory。127.0.0.1 最穩妥。localhost 僅指**容器自身**,不指宿主機或其他容器。mysql -h mysql-service。-p 3306:3306,用 127.0.0.1。127.0.0.1**(或服務發現域名),**永不使用 localhost**。'localhost'、'127.0.0.1'、'%'**(或具體 IP 段)。my.cnf 統一 socket 路徑,並在 [client] 區段同步設定。Aborted_connects 異常增長 → 排查 Socket/權限/防火牆。