MySQL 連接報錯：Can't connect to local MySQL server through socket 解決方案

MySQL 連接報錯：Can't connect to local MySQL server through socket 解決方案

錯誤完整信息：

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock' (2)

根因分析

MySQL Client 預設讀取 /etc/my.cnf 中 [client] 區塊的 socket 參數，或編譯時的默認路徑 /var/lib/mysql/mysql.sock。若 Server 實際運行的 socket 路徑被修改（如遷移數據目錄），Client 找不到 Socket 文件，拋出此錯。

場景還原

雲平台（Azure）MySQL 實例，供應商修改了數據目錄與 Socket 路徑：

[mysqld]
datadir=/dat/data/mysql
socket=/dat/data/mysql/mysql.sock

但 Client 仍嘗試連接 /var/lib/mysql/mysql.sock，導致失敗。

解決方案（三選一）

方案 1：建立軟連接（最快、無需改代碼）

ln -s /dat/data/mysql/mysql.sock /var/lib/mysql/mysql.sock
# 若 /var/lib/mysql 目錄不存在，先建立目錄
mkdir -p /var/lib/mysql
ln -s /dat/data/mysql/mysql.sock /var/lib/mysql/mysql.sock

方案 2：客戶端指定 Socket 參數

mysql -uroot -p -S /dat/data/mysql/mysql.sock
# 或在 [client] 區塊配置
[client]
socket=/dat/data/mysql/mysql.sock

方案 3：應用層連接字串指定

# JDBC
jdbc:mysql://localhost:3306/db?socketFactory=com.mysql.jdbc.NamedPipeSocketFactory
# 或使用 TCP 連接（繞過 Socket）
jdbc:mysql://127.0.0.1:3306/db

驗證

mysql -uroot -p
# 能正常進入交互模式即成功

最佳實踐

• 統一由配置管理工具（Ansible/Puppet）分發 my.cnf，保證 Client/Server 一致
• 生產環境建議使用 TCP（127.0.0.1:3306）而非 Unix Socket，避免路徑不一致問題
• 遷移數據目錄時，同步更新 datadir、socket、pid-file、log-error 等所有路徑相關參數

Socket 找不到本質是「Client 與 Server 對 Socket 路徑認知不一致」，對齊即可解決。