MacOS 上装 MySQL 最省事的方式是用 Homebrew，跳过官网下载、手动配置、权限修复等一堆坑；但直接
brew install mysql装出来的默认配置不支持远程连接、root 密码为空、甚至可能启动失败——这些不是“装好了就行”，而是后续连不上、改不了、跑不动的根源。
用 Homebrew 安装并启动 MySQL 服务
Homebrew 是 MacOS 下最可靠的包管理器，MySQL 官方也推荐这种方式。执行以下命令即可完成安装和首次启动：
确保已安装 Homebrew：brew --version，没装就先运行官网一键脚本 安装 MySQL：
brew install mysql启动服务：
brew services start mysql（后台常驻）或
mysql.server start（临时） 验证是否运行：
mysqladmin -u root ping，返回
mysqld is alive即成功
注意：Homebrew 安装的 MySQL 默认监听
127.0.0.1:3306，不绑定
0.0.0.0，所以本地能连，但其他机器或 Docker 容器默认连不上。
初始化 root 密码并禁用空密码登录
Homebrew 安装后 root 用户默认无密码，且允许空密码登录，这在开发环境看似方便，实则会触发 MySQL 8.0+ 的严格认证插件（
caching_sha2_password），导致某些客户端（如旧版 Navicat、DBeaver 默认配置）根本连不上。 先用空密码登录：
mysql -u root执行修改密码并强制使用兼容插件：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_secure_password';刷新权限：
FLUSH PRIVILEGES;退出后重试：
mysql -u root -p，输入新密码应能成功
别跳过这步——否则你后面会反复遇到
Access denied for user 'root'@'localhost'或客户端报错
Public Key Retrieval is not allowed。
修改 my.cnf 允许远程访问（可选但常见需求）
开发中常需从 Docker 容器、另一台 Mac 或 iOS 模拟器访问 MySQL，这时必须改配置文件放开绑定地址，并开放对应用户权限。
找到配置文件路径：brew --prefix mysql返回类似
/opt/homebrew/opt/mysql，配置文件通常在
etc/my.cnf或
my.cnf.d/client.cnf编辑该文件，在
[mysqld]段下添加：
bind-address = 0.0.0.0 port = 3306重启服务：
brew services restart mysql授权远程访问（在 MySQL 内执行）：
CREATE USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_secure_password'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;
注意 macOS 防火墙默认不拦截 3306，但如果你开了「防火墙」或用了企业网络策略，仍需手动放行端口；另外
bind-address = 0.0.0.0不等于“对外暴露”，它只是让 MySQL 监听所有接口，真正能否连上还取决于用户权限和网络可达性。
常见启动失败原因及修复
Homebrew 启动 MySQL 失败时，
brew services list显示
error，日志通常藏在：
$(brew --prefix mysql)/var/mysql/你的主机名.local.err。高频问题有三个：
Can't start server: Bind on TCP/IP port: Address already in use：说明 3306 被占用，查进程：
lsof -i :3306，杀掉或改配置端口
Table 'mysql.plugin' doesn't exist：初始化未完成，删掉数据目录重装：
rm -rf $(brew --prefix mysql)/var/mysql，再执行
mysql_install_db（MySQL 5.7）或
mysqld --initialize（MySQL 8.0+）
Operation not permitted（macOS Ventura/Monterey）：系统完整性保护（SIP）限制了某些路径写入，建议把 MySQL 数据目录移到用户目录下，例如
~/mysql-data，并在
my.cnf中显式指定
datadir = /Users/xxx/mysql-data
MySQL 在 macOS 上的“开箱即用”其实是个幻觉——它对路径权限、系统版本、ARM/x86 架构都敏感，哪怕只差一个配置项，就可能卡在启动环节。动手前先看日志，别猜。
