Docker 運行 MySQL 容器,宿主機 33067 映射容器 3306。本地客戶端連接時:
mysql -uroot -P33067 → 連上宿主機本地 MySQL(Unix Socket)mysql -uroot -hlocalhost -P33067 → 同樣連上宿主機(localhost 強制 Unix Socket)mysql -uroot -h172.17.0.2 → 正常連入容器內 MySQLmysql -uroot -h127.0.0.1 -P33067 → 正常連入容器(TCP 回環)當 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。
| 場景 | 正確連接命令 | 錯誤示範 |
|---|---|---|
| 本地 TCP 連接 | mysql -h127.0.0.1 -P3306 | mysql -hlocalhost -P3306 |
| Docker 端口映射 | mysql -h127.0.0.1 -P33067 | mysql -P33067 或 -hlocalhost |
| 遠程連接 | mysql -h192.168.1.100 -P3306 | mysql -hremote-host(需 DNS 解析) |
| 強制 Unix Socket | mysql -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 多年保持的歷史行為,認清它,繞過坑。