macOS 安裝 MySQL 後啟動報 ERROR 2002 (HY000) 解決方案

macOS MySQL Socket 連接失敗快速修復

報錯現象

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

原因分析

官方 DMG 安裝包默認將 Socket 放在 /tmp/mysql.sock，而客戶端默認尋找 /var/lib/mysql/mysql.sock，路徑不匹配導致連接失敗。

標準啟動流程（官方 README）

1. 若安裝了啟動項：

   sudo /Library/StartupItems/MySQLCOM/MySQLCOM start

2. 若未安裝啟動項（手動啟動）：

   cd /usr/local/mysql
   sudo ./bin/mysqld_safe &
   # 按 Ctrl+Z 暫停
   bg  # 後台運行
   # 按 Ctrl+D 退出 shell

啟動成功後，使用 /usr/local/mysql/bin/mysql 連接即可。

永久修復 Socket 路徑

# 1. 編輯 /etc/my.cnf (若無則創建)
[client]
socket = /tmp/mysql.sock

[mysqld]
socket = /tmp/mysql.sock

重啟 MySQL 服務後，所有客戼端均能正確找到 Socket。

驗證

mysql -uroot -p
# 成功進入交互界面