萬盛學電腦網

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

MySQL 客戶端連接陷阱:未指定 IP 默認走 Unix Socket 連 localhost

問題現場

Docker 運行 MySQL 容器,宿主機 33067 映射容器 3306。本地客戶端連接時:

  • mysql -uroot -P33067 → 連上宿主機本地 MySQL(Unix Socket)
  • mysql -uroot -hlocalhost -P33067 → 同樣連上宿主機(localhost 強制 Unix Socket)
  • mysql -uroot -h172.17.0.2 → 正常連入容器內 MySQL
  • mysql -uroot -h127.0.0.1 -P33067 → 正常連入容器(TCP 回環)

根因:MySQL 客戶端對 "localhost" 的特殊處理

當 host 為 "localhost" 或未指定(默認 localhost)時,MySQL 客戶端強制使用 Unix Domain Socket 連接本地 mysqld,完全忽略 -P 指定的端口號。

這是客戶端庫的內建行為,而非服務端配置。

驗證方法


mysql> STATUS;
Connection: Localhost via UNIX socket
UNIX socket: /var/run/mysqld/mysqld.sock

看到 Localhost via UNIX socket 即確認走本地 Socket。

最佳實踐:永遠顯式指定 IP

場景正確連接命令錯誤示範
本地 TCP 連接mysql -h127.0.0.1 -P3306mysql -hlocalhost -P3306
Docker 端口映射mysql -h127.0.0.1 -P33067mysql -P33067 或 -hlocalhost
遠程連接mysql -h192.168.1.100 -P3306mysql -hremote-host(需 DNS 解析)
強制 Unix Socketmysql -S /var/run/mysqld/mysqld.sock僅本機調試用

配置文件 [client] 區同樣生效


[client]
host = 127.0.0.1   # 不要寫 localhost
port = 3306

總結

MySQL 客戶端:未指定 IP = localhost = Unix Socket(忽略端口)。容器映射、隧道轉發、多實例端口區分等場景,務必顯式使用 127.0.0.1 或具體 IP,避免「以為連遠程,實際連本地」的低級錯誤。這不是 Bug,是客戶端庫 20 多年保持的歷史行為,認清它,繞過坑。

copyright © 萬盛學電腦網 all rights reserved