必须验证Homebrew为ARM原生(arch输出arm64、which brew为/opt/homebrew/bin/brew),安装mysql@8.0而非mysql,手动--initialize-insecure初始化并切换认证插件为mysql_native_password,最后配置PATH使mysql命令可用。

确认 Homebrew 是 ARM 原生模式
装错架构是后续所有问题的根源。Homebrew 必须运行在 arm64 下,且安装路径必须是 /opt/homebrew。否则 brew install mysql@8.0 拉下来的极可能是 x86_64 二进制包,性能打折、Navicat 连不上、甚至 mysqld 启动失败。
执行两行命令验证:
-
which brew输出必须是/opt/homebrew/bin/brew;如果是/usr/local/bin/brew,说明装了 Intel 版,得重装 -
arch输出必须是arm64;如果看到i386或x86_64,说明终端开了 Rosetta——右键「终端」→「显示简介」→取消勾选「使用 Rosetta 运行」
确认无误后,再跑 brew update && brew upgrade,确保 formula 是最新 ARM 适配版。
安装 mysql@8.0 而不是 mysql
Homebrew 默认 mysql 已指向 MySQL 9.x(如 9.5),直接 brew install mysql 会装错版本,且与旧项目不兼容。必须显式指定 mysql@8.0。
执行:
brew install mysql@8.0- 安装完成后,
brew services start mysql@8.0启动服务 - 注意:它不会自动 symlink 到
/usr/local/bin/mysql,这是正常行为(keg-only)
验证是否 ARM 原生:/opt/homebrew/opt/mysql@8.0/bin/mysql -V,输出里必须含 macos22-arm64 或类似字样,不能有 x86_64。
手动初始化 + 降级认证插件
MySQL 8.0 默认启用 validate_password 插件和 caching_sha2_password 认证方式,导致 mysql_secure_installation 直接报错 ERROR 1819 (HY000),Navicat / Laravel Sail 等工具也连不上。
适用于 macOS 12+ Apple 增强版 SYSU 工作流,支持自然语言指令,如同步课表至日历、添加雨课堂截止日期至提醒事项、将宣讲会或招聘会写入日历等。
正确流程是:
- 先停服务:
brew services stop mysql@8.0 - 手动初始化(关键!用
--initialize-insecure):/opt/homebrew/opt/mysql@8.0/bin/mysqld --initialize-insecure --user=$(whoami) --basedir=/opt/homebrew/opt/mysql@8.0 --datadir=/opt/homebrew/var/mysql@8.0 - 重启服务:
brew services start mysql@8.0 - 无密登录:
mysql -u root,然后立即执行:ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
这一步跳过了密码强度校验,也把认证方式切回兼容性更好的 mysql_native_password。
配置 PATH 并验证命令可用
Homebrew 不会自动把 mysql@8.0 的 bin 加入 $PATH,所以敲 mysql --version 会报 command not found。
Apple Silicon 用户只需执行:
echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrcsource ~/.zshrc- 再验证:
mysql --version应输出mysql Ver 8.0.x
别漏掉 source,否则 shell 不会重载新 PATH;也别用 ~/.bash_profile(macOS 10.15+ 默认用 zsh)。
真正容易被忽略的是三件事:架构验证、--initialize-insecure 初始化、以及认证插件切换——少一个,mysql -u root -p 就永远连不上。

















