在 macOS 上使用 Homebrew 安装 MySQL 是一种高效且常用的方式，但在实际操作中可能会遇到一些常见问题。下面列出几个典型问题及其解决方案，帮助你顺利完成安装与配置。
1. 安装时报错：Error: No available formula with the name "mysql"
这通常是因为 Homebrew 的包索引未更新或缺少必要的仓库。
解决方法： 先运行brew update更新 Homebrew 到最新版本。 尝试搜索确认包名是否存在：
brew search mysql，正确名称应为
mysql。 如果仍找不到，可手动添加核心仓库：
brew tap homebrew/core，然后再试安装。
2. 启动 MySQL 失败：ERROR! The server quit without updating PID file
这个问题多由数据目录权限错误或残留配置引起。
解决方法： 检查是否已有 MySQL 进程在运行：ps aux | grep mysqld，若有则终止：
kill -9 <pid></pid>。 删除或重命名旧的数据目录（默认路径为
/usr/local/var/mysql），然后重新初始化：
brew postinstall mysql。 确保当前用户对数据目录有读写权限：
sudo chown -R $(whoami) /usr/local/var/mysql。
3. root 用户无法登录：Access denied for user 'root'@'localhost'
可能是密码未设置或忘记，也可能是认证方式不匹配。
解决方法： 先停止 MySQL 服务：brew services stop mysql。 以跳过权限表方式启动：
mysqld_safe --skip-grant-tables &。 打开新终端，执行
mysql -u root直接进入。 在 MySQL 命令行中重置密码（MySQL 8+）：
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';执行后退出并重启 MySQL：
brew services restart mysql。
4. MySQL 服务无法开机自启或状态异常
使用 brew services 管理时可能出现加载失败或状态显示 error。
解决方法： 重置服务配置：brew services cleanup。 重新加载服务：
brew services restart mysql。 查看详细日志定位问题：
tail -f /usr/local/var/mysql/$(hostname).err。 确保 launchctl 正常加载，必要时手动卸载再注册：
launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist，然后
brew services start mysql重新生成。
5. 安装后命令行工具 mysql 不可用
虽然安装成功，但输入
mysql提示 command not found。 解决方法： 检查是否已链接：
brew link mysql（注意：新版可能自动链接）。 将 MySQL 的 bin 目录加入 PATH。编辑 shell 配置文件（如
~/.zshrc或
~/.bash_profile）：
export PATH="/usr/local/opt/mysql/bin:$PATH"保存后运行
source ~/.zshrc生效。
基本上就这些。只要保持 Homebrew 更新、注意权限和路径设置，大多数问题都能快速解决。安装完成后建议运行
mysql_secure_installation来提升安全性。
