萬盛學電腦網

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

解決「Can't connect to local MySQL server through socket」連線失敗

錯誤訊息解讀

Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2) 表示:
客戶端嘗試透過 Unix Socket /tmp/mysql.sock 連線,但該檔案不存在或不可存取。

五大排查方案(按成功率排序)

方案一:MySQL 服務未啟動或卡住

ps -ef | grep mysqld
# 若有殘留進程
kill -9 
systemctl restart mysqld  # 或 service mysqld restart

方案二:資料目錄權限錯誤

chown -R mysql:mysql /var/lib/mysql
systemctl restart mysqld

方案三:max_connections 設定過大導致啟動失敗

檢查 /etc/my.cnf:

[mysqld]
max_connections = 500  # 降低嘗試,視記憶體而定

過大值會導致啟動時記憶體分配失敗,服務雖啟動但 Socket 未建立。

方案四:Socket 路徑不一致(最常見)

**現象**:MySQL 實際建立 Socket 在 /var/lib/mysql/mysql.sock,但客戶端(含 PHP)預設讀 /tmp/mysql.sock。

**修法 1:修改 my.cnf 統一路徑**

[mysqld]
socket=/var/lib/mysql/mysql.sock
[client]
socket=/var/lib/mysql/mysql.sock

**修法 2:建立軟連結(快速臨時修復)**

ln -s /var/lib/mysql/mysql.sock /tmp/mysql.sock

**修法 3:PHP 端指定 Socket**

mysqli_connect('localhost', 'user', 'pass', 'db', 3306, '/var/lib/mysql/mysql.sock');

方案五:找不到 mysql.sock 只有 mysqld.sock

部分安裝方式 Socket 命名為 mysqld.sock,位於 /var/run/mysqld/:

ln -s /var/run/mysqld/mysqld.sock /tmp/mysql.sock

驗證連線

mysql -u root -p -S /var/lib/mysql/mysql.sock  # 顯式指定 Socket
mysql -h 127.0.0.1 -u root -p  # 強制走 TCP/IP 繞過 Socket

根因總結表

systemctl restart mysqldchown -R mysql:mysql /var/lib/mysql修正 client 段 socket 參數各實例指定不同 socket 檔
現象根因修復
Socket 檔不存在服務未啟動/啟動失敗
Permission denied資料目錄擁有者非 mysql
客戶端找不到 Socketmy.cnf [client] socket 路徑錯誤
多實例衝突多個 mysqld 搶佔同一 Socket

**核心原則:統一 Server/Client Socket 路徑,或用 TCP/IP (127.0.0.1) 避開 Socket 機制。**

copyright © 萬盛學電腦網 all rights reserved