Mac 安裝 MySQL 後桌面客戶端連接失敗：端口號不匹配

問題現象

終端命令行可正常登入 MySQL、建庫建表，但 Navicat、MySQL Workbench 等 GUI 客戶端連接報錯，嘗試多個客戶端均失敗。

排查步驟

1. 確認 MySQL 服務已啟動：mysql.server status。
2. 查看 MySQL 實際監聽端口：lsof -i :3306 或在 MySQL 客戶端執行 SHOW VARIABLES LIKE 'port';。
3. Mac 版 MySQL 預設端口可能為 3307（而非標準 3306），尤其 Homebrew 安裝或多版本共存時。

解決方法

修改客戶端連接配置

在客戶端新建連接時，將 Port 設置為實際端口（如 3307），Host 保持 127.0.0.1 或 localhost。

或修改 MySQL 配置文件統一端口

編輯 /etc/my.cnf 或 /usr/local/etc/my.cnf：

[mysqld]
port = 3306

重啟服務：mysql.server restart。

其他常見原因

• 未授權遠程連接：需執行 GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'password'; FLUSH PRIVILEGES;。
• 防火牆/安全組阻擋端口。
• MySQL 8.0+ 默認認證插件 caching_sha2_password 導致舊版客戶端不兼容，需改用 mysql_native_password 或升級客戶端。