mysql命令找不到是因为Homebrew未自动将MySQL二进制路径加入PATH，需根据芯片类型手动配置：Apple Silicon（arm64）执行echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc；Intel（x86_64）执行echo 'export PATH="/usr/local/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc，再运行mysql --version验证。
装完 brew install mysql@8.0 后，mysql --version 报 command not found 是最常见卡点，不是没装好，是 PATH 没配对 —— Apple Silicon 和 Intel 路径不同，硬背会错。
为什么 mysql 命令找不到？
Homebrew 不会自动把 MySQL 的二进制路径加进 $PATH。装完后可执行文件实际在：
- Apple Silicon（M1/M2/M3）：
/opt/homebrew/opt/mysql@8.0/bin/ - Intel Mac：
/usr/local/opt/mysql@8.0/bin/
不确定芯片类型？终端运行 arch：输出 arm64 就是 Apple Silicon，x86_64 是 Intel。
配法很简单，选对路径执行一行即可：
- Apple Silicon：
echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - Intel：
echo 'export PATH="/usr/local/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
验证是否生效：mysql --version 能打出 mysql Ver 8.0.x 才算成功。别跳过这步 —— 后面所有操作都依赖这个命令可用。
mysql_secure_installation 运行失败或连不上 root
MySQL 8.0+ 默认 root@localhost 没密码，但 mysql_secure_installation 第一步就要求输强密码（至少 8 位、大小写+数字+符号），容易卡住。
常见流程断点和解法：
- 先确保服务已启动：
brew services start mysql@8.0 - 如果提示
Access denied for user 'root'@'localhost'，说明服务起来了但没初始化密码 —— 此时不能直接mysql -u root -p，得先免密进：sudo mysql -u root - 进库后手动设密码：
ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourPass123!'; - 退出再重试：
mysql_secure_installation就能继续了 - 开发环境想跳过强密码校验？第一步输入
n，后续再设简单密码（如123456）
客户端连接报 Client does not support authentication protocol
这是 MySQL 8.0 默认认证插件 caching_sha2_password 导致的。老版本 Python 的 mysqlclient、Node.js 的 mysql2（
唯一有效解法：进 MySQL 手动切回兼容插件：
- 用
mysql -u root -p登录后执行：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourPass123!'; - 注意：必须带
BY 'xxx'显式指定密码，否则只改插件不改密码，下次仍连不上 - 改完立刻退出重连，验证是否生效
别指望靠客户端升级绕开 —— 很多项目锁死旧版驱动，改服务端认证是最稳的方案。
服务启动失败或 brew services start 看似成功却连不上
brew services start mysql@8.0 显示 started，但 ps aux | grep mysqld 查不到进程，或 mysql -u root -p 直接超时，大概率是数据目录权限或残留 PID 文件问题。
推荐排查顺序：
- 先停掉所有可能冲突进程：
brew services stop mysql@8.0+mysql.server stop - 清端口：
lsof -i :3306，有残留就kill -9 - 检查数据目录属主：
ls -la /opt/homebrew/var/mysql（Apple Silicon）或/usr/local/var/mysql（Intel），如果不是当前用户，执行：sudo chown -R $(whoami) /opt/homebrew/var/mysql - 删残留 PID：
rm -f /opt/homebrew/var/mysql/*.pid - 再启动：
brew services start mysql@8.0
真正要命的不是装不装得上，而是第一次初始化时权限没对齐 —— 这个细节几乎没人提，但 70% 的“启动失败”都栽在这儿。
