最省事方式是用Homebrew安装MySQL，但需配置远程访问、设置root密码并解决启动失败问题；默认监听127.0.0.1且空密码，须改my.cnf绑定0.0.0.0、授权root@'%'、禁用caching_sha2_password插件。
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 架构都敏感，哪怕只差一个配置项，就可能卡在启动环节。动手前先看日志，别猜。
