Homebrew安装MySQL 8.4在macOS上需避三坑：认证插件（caching_sha2_password）导致加-p登录失败，须首次无密码登录后ALTER USER重置；端口3306被占引发启动失败，需lsof查杀冲突进程；客户端连不上因localhost与127.0.0.1授权分离，应创建对应用户并授权，且PATH必须手动添加/opt/homebrew/bin或/usr/local/bin。
Homebrew 安装 MySQL 8.4 在 macOS 上本身不难，但“优雅”体现在三点：不踩认证插件坑、不被 socket 连接绕晕、不因 PATH 缺失白忙活。默认 brew install mysql 现在拉的是 8.4.x（2026 年最新稳定版），但直接跑起来后，mysql -u root 能进，mysql -u root -p 却报错，就是典型没处理好 caching_sha2_password 认证和初始权限的问题。
为什么 mysql -u root 能登录，但加 -p 就 Access denied？
MySQL 8.4 默认为 root@localhost 用户分配了 caching_sha2_password 插件，且初始密码为空——但这不等于“无密码认证”，而是要求你显式用空密码登录（即回车跳过输密）。一旦你执行过任何密码设置操作（比如误运行 mysql_secure_installation 中途退出），或手动改过用户，就可能卡在插件不匹配上。
- 首次登录必须不带
-p：mysql -u root，直接回车 - 进去后立刻执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'your_strong_password'; - 紧接着必须执行：
FLUSH PRIVILEGES;（否则权限不生效） - 退出再试：
mysql -u root -p，输入刚设的密码——这才算真正打通
brew services start mysql 启动失败，日志里写 “Can't start server: Bind on TCP/IP port: Address already in use”
这是端口 3306 被占用了，不是 MySQL 自身配置问题。Mac 上常见抢占者是：Docker 的 MySQL 容器、Sequel Ace 后台残留进程、或是之前没杀干净的 mysqld 实例。
- 查谁占着：
lsof -i :3306（看 PID） - 干掉它：
kill -9 PID（把上面查到的数字替换进去） - 别依赖
mysql.server start：Homebrew 安装的 MySQL 服务由brew services管理，混用会冲突 - 启动前清残留数据目录（仅重装时需要）：
rm -rf /opt/homebrew/var/mysql（Apple Silicon）或rm -rf /usr/local/var/mysql（Intel）
客户端连不上，报 “Host 'localhost' is not allowed to connect to this MySQL server”
这不是网络或防火墙问题，是 MySQL 用户授权绑定了 127.0.0.1 而非 localhost。macOS 下 localhost 默认走 Unix socket，而很多 GUI 客户端（TablePlus、Beekeeper Studio）默认尝试 TCP 连接，结果匹配不到用户记录。
- 登录后执行：
CREATE USER 'root'@'127.0.0.1' IDENTIFIED BY 'your_strong_password'; - 再赋权：
GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION; - 然后客户端连接时，“Host” 填
127.0.0.1，别填localhost - 如果非要
localhost可用，得确认 socket 路径：mysql --socket=/opt/homebrew/var/mysql/mysql.sock -u root -p
最常被忽略的其实是 shell PATH —— Homebrew 安装完不会自动加进你的 $PATH。M1/M2/M3 Mac 路径是 /opt/homebrew/bin，Intel 是 /usr/local/bin，不手动加进去，终端永远提示 command not found: mysql，哪怕服务跑得好好的。
