MySQL mysql.sock 完整指南：本地 Socket 連線原理、配置與故障排查

MySQL mysql.sock 完整指南：本地 Socket 連線原理、配置與故障排查

mysql.sock 是 MySQL 客戶端與 Server 在同一主機上進行進程間通信 (IPC) 的 Unix Domain Socket 文件。它繞過 TCP/IP 協議棧，提供更低延遲、更高吞吐的本地連線方式。本文系統解析其生成機制、配置管理、連線優先級與常見故障處理。

一、核心原理與生成機制

• 本質：文件系統中的特殊文件 (類型 s)，在 MySQL Server 啟動時由 Server 進程創建
• 生命週期：mysqld 啟動 → 創建 → 監聽 → 客戶端連接 → mysqld 關閉 → 自動刪除
• 權限模型：文件權限決定哪些 OS 用戶可連接 (通常 mysql:mysql、660)
• 唯一性：單實例單 Socket，多實例需指定不同路徑

二、配置管理：三層優先級

標準配置範例 (/etc/my.cnf)

[mysqld]
socket = /var/lib/mysql/mysql.sock   # 或 /tmp/mysql.sock, /run/mysqld/mysqld.sock
# 基於 datadir 相對路徑較常見：/var/lib/mysql/mysql.sock

[client]
socket = /var/lib/mysql/mysql.sock   # 統一客戶端預設

[mysql]
socket = /var/lib/mysql/mysql.sock   # mysql 命令列專用

三、連線方式對比：Socket vs TCP/IP

MySQL 客戶端智能選擇邏輯：

1. 顯式指定 -h (非 localhost) → TCP/IP
2. 顯式指定 -S/--socket → Socket
3. -h localhost 或無 -h 參數 → **優先 Socket** (讀取 [client] socket 配置)
4. -h 127.0.0.1 → **強制 TCP/IP** (繞過 Socket)

四、常見故障與排查指南

故障 1：Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

# 1. 確認 MySQL 進程是否運行
ps -ef | grep mysqld
systemctl status mysqld

# 2. 確認實際 Socket 路徑
# 方法 A：查看配置文件
grep socket /etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf 2>/dev/null

# 方法 B：查看進程啟動參數
ps -ef | grep mysqld | grep -o 'socket=[^ ]*'

# 方法 C：查找文件系統
find / -name 'mysql.sock' -type s 2>/dev/null
ls -la /var/lib/mysql/mysql.sock /tmp/mysql.sock /run/mysqld/mysqld.sock

# 3. 修正連線參數
mysql -S /var/lib/mysql/mysql.sock -u root -p  # 指定正確路徑
# 或修改 my.cnf [client] socket 後重新連線

故障 2：Socket 文件誤刪除 / 遺失

# 現象：MySQL 進程仍在運行，但 mysql.sock 不見了
# 原因：手動刪除、logrotate 執行、tmpwatch 清理 /tmp

# 解決：重啟 MySQL 服務 (唯一標準恢復方式)
systemctl restart mysqld
# 重啟過程中 Server 會重新創建 Socket 文件

# 預防：配置 Socket 路徑避開 /tmp (如 /var/lib/mysql/ 或 /run/mysqld/)
# 修改 my.cnf [mysqld] socket=/var/lib/mysql/mysql.sock

故障 3：多實例 Socket 衝突

# 每個實例必須指定唯一 Socket 路徑
# 實例 1 (3306)
[mysqld]
socket = /var/lib/mysql3306/mysql.sock
port = 3306

# 實例 2 (3307)
[mysqld]
socket = /var/lib/mysql3307/mysql.sock
port = 3307

# 客戶端連線時必須同時指定 -P 和 -S
mysql -P 3307 -S /var/lib/mysql3307/mysql.sock -u root -p

故障 4：權限拒絕

# 現象：ERROR 2002 (HY000): Can't connect ... Permission denied
# 原因：Socket 文件屬主/權限不匹配
ls -la /var/lib/mysql/mysql.sock
# srwxrwxrwx 1 mysql mysql 0 Jan 1 10:00 /var/lib/mysql/mysql.sock

# 修正：確保客戶端執行用戶在 mysql 組中，或調整目錄權限
usermod -a -G mysql appuser
# 或臨時調整 (不推薦生產)
chmod 666 /var/lib/mysql/mysql.sock

五、容器化環境特殊考量

• Volume 掛載：將 Socket 目錄掛載到宿主機或 Sidecar 容器 -v /var/lib/mysql:/var/lib/mysql
• 網路模式：--network host 時可直接用宿主機 Socket；Bridge 模式需映射端口走 TCP
• Sidecar 模式：備份/監控 Sidecar 共享 Volume 通過 Socket 連線，避免暴露端口

六、最佳實踐清單

1. 統一路徑：全環境標準化為 /var/lib/mysql/mysql.sock (RPM/Debian 預設) 或 /run/mysqld/mysqld.sock (systemd 臨時目錄)
2. 避開 /tmp：tmpwatch/systemd-tmpfiles 會定期清理 /tmp 導致 Socket 丟失
3. 配置對齊：[mysqld]、[client]、[mysql] 三處 socket 參數完全一致
4. 監控檢查：定期檢查 Socket 文件存在性、權限、進程綁定狀態
5. 連線策略：本地管理腳本、備份工具、監控 Agent **強制使用 Socket**；應用服務視網路拓撲選擇

掌握 mysql.sock 的生成邏輯、配置優先級與連線選擇機制，能快速解決 90% 的本地連線故障，並通過 Socket 連線釋放本地 TCP 端口資源、降低延遲。將標準化路徑、權限模型、監控檢查納入基礎設施規範，是穩定運維的基石。