萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 主機名 127.0.0.1 vs localhost 深度解析:協議差異、權限匹配、連線失敗排查

localhost 與 127.0.0.1 在 MySQL 連線中**代表完全不同的傳輸協議與權限匹配規則**,是導致「同機器能連、遠程不能連」或「PHP 連不上、命令列能連」的高頻根因。本文深度解析協議差異、權限表匹配邏輯、實戰排查案例與最佳實踐配置。

核心差異總覽

維度localhost127.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 按 **(User, Host) 元組**匹配權限表,**精確匹配優先**。
  • 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。

實戰排查案例:PHP 連不上、命令列能連

現象

  • 命令列:mysql -u root -p ✅ 成功
  • PHP 代碼:mysqli_connect('localhost', ...) ❌ Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock'

根因

  1. PHP 使用 localhost → 走 Unix Socket。
  2. MySQL 配置 socket=/tmp/mysql.sock,但 PHP 預設尋找 /var/lib/mysql/mysql.sock(或編譯時指定路徑)。
  3. Socket 路徑不一致 → 連線失敗。
  4. 三種解決方案(推薦順序)

    1. 應用配置改用 127.0.0.1(最推薦):
      $host = '127.0.0.1'; → 強制走 TCP,跨平台一致、無 Socket 路徑問題、支援容器化。
    2. 統一 Socket 路徑:
      my.cnf 同時在 [mysqld]、[client]、[mysql] 設定 socket=/var/lib/mysql/mysql.sock → 重啟 MySQL。
    3. 建立軟連結(無需重啟):
      ln -s /tmp/mysql.sock /var/lib/mysql/mysql.sock

    配置檔強制 TCP 協議

    
    # my.cnf
    [client]
    protocol = tcp
    # 或
    [mysql]
    protocol = tcp
    

    客戶端讀取此配置後,localhost 也會走 TCP 連線,繞過 Socket 問題。

    Windows 環境特殊性

    • Windows 無 Unix Socket,**localhost 默認走 TCP**(經過 Winsock 解析為 127.0.0.1)。
    • 可啟用 Named Pipe / Shared Memory:[mysqld] enable-named-pipe / shared-memory。
    • PHP Windows 通常直接用 127.0.0.1 最穩妥。

    Docker / Kubernetes 容器化環境

    • 容器內 localhost 僅指**容器自身**,不指宿主機或其他容器。
    • 應用容器連 MySQL 容器:**必須用服務名/容器 IP**,mysql -h mysql-service。
    • 宿主機連容器 MySQL:映射端口 -p 3306:3306,用 127.0.0.1。

    最佳實踐清單

    1. **應用程式配置統一使用 127.0.0.1**(或服務發現域名),**永不使用 localhost**。
    2. 權限表建立用戶時,**同時授權 'localhost'、'127.0.0.1'、'%'**(或具體 IP 段)。
    3. my.cnf 統一 socket 路徑,並在 [client] 區段同步設定。
    4. 監告警:Aborted_connects 異常增長 → 排查 Socket/權限/防火牆。
    5. 容器化環境**禁用 Socket,全面 TCP**。
copyright © 萬盛學電腦網 all rights reserved