// MySQL 錯誤參考

MySQL 錯誤 2002:無法透過通訊端連線

客戶端嘗試了本機 Unix 通訊端,但沒有找到伺服器。可能是伺服器未執行、使用了別的通訊端路徑,或者你其實想用 TCP 連線。

錯誤號碼
2002
名稱
CR_CONNECTION_ERROR
類別
連線與用戶端
錯誤訊息
Can't connect to local MySQL server through socket '%s' (%d)

它的意義

當你連線到 localhost 在 Unix 上,MySQL 用戶端會改用 Unix socket 檔案而不是 TCP。錯誤 2002 表示 socket 檔案不存在,或沒有程式在監聽它。方括號裡的數字是作業系統的錯誤編號,例如 (2) 表示沒有此類檔案, (111) 表示連線被拒絕。

這是用戶端錯誤:請求從未送達伺服器。

常見原因

  • MySQL 伺服器沒有在執行,或是啟動時就當掉了。
  • 伺服器的通訊端所在位置與用戶端預期的不同(例如 /var/run/mysqld/mysqld.sock 對上 /tmp/mysql.sock).
  • 伺服器執行在 Docker 或另一台機器上,因此沒有本機通訊端;你需要使用 TCP。
  • 通訊端目錄的權限會讓用戶端無法存取它。

如何修正

  1. 檢查伺服器是否正在執行,若沒有則讀取其錯誤記錄,例如使用 systemctl status mysql Linux 上或者 brew services list macOS 上。

  2. 改以 TCP 連線而非 socket,使用 127.0.0.1 而不是 localhost,或 --protocol=TCP.

    mysql -h 127.0.0.1 -P 3306 -u app -p
  3. 如果伺服器在本機執行,請找出它的 socket 路徑,並讓客戶端指向它。

    -- On the server:
    SHOW VARIABLES LIKE 'socket';
    -- Client:
    mysql --socket=/var/run/mysqld/mysqld.sock -u app -p

相關錯誤

更多連線與用戶端錯誤

程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。