homebrew 自2024年8月1日起禁用 mysql@5.7，因其上游已停止支持；需通过设置 homebrew_no_install_from_api=1、同步 core 仓库、编辑 formula 注释 disable! 行（含 openssl@1.1）、并手动配置 path 和服务才能成功安装与运行。
不能直接 brew install mysql@5.7 —— 这个命令在 2024 年 8 月 1 日后已彻底失效，不是网络或权限问题，而是 Homebrew 主动禁用了该 formula。
为什么 brew install mysql@5.7 直接报错
错误信息明确显示：Error: mysql@5.7 has been disabled because it is not supported upstream! It was disabled on 2024-08-01.。Homebrew 自 4.0.0 版本起（2024 年中之后普遍更新）默认拒绝从远程 API 获取被标记为 disabled 的 formula。即使你用的是 M1/M2 Mac，只要 Homebrew 是当前版本（2026 年绝大多数用户都已是 ≥ 4.0.0），就会触发该限制。
这不是 bug，是官方策略：MySQL 5.7 已结束上游支持，Homebrew 同步执行了禁用。绕过它需要强制使用本地 formula 并手动解除禁用标记。
必须执行的四步绕过操作
缺一不可，顺序也不能乱：
- 设置环境变量跳过远程 API：
export HOMEBREW_NO_INSTALL_FROM_API=1 - 强制同步本地 core 仓库（确保 formula 文件存在）：
brew tap --force homebrew/core - 编辑 MySQL 5.7 formula 并注释禁用行：
brew edit mysql@5.7→ 找到并注释这行：# disable! date: "2024-08-01", because: :unsupported - 同理处理强依赖项
openssl@1.1（它也在 2024 年 10 月被禁用）：brew edit openssl@1.1→ 注释掉它的disable!行
完成后，安装命令必须带环境变量前缀：HOMEBREW_NO_INSTALL_FROM_API=1 brew install mysql@5.7。漏掉前缀仍会失败。
安装后 PATH 和服务配置容易被忽略
mysql@5.7 是 keg-only 版本，Homebrew 不会自动创建符号链接，也不会修改你的 PATH。不手动处理，终端里敲 mysql 就会提示 command not found。
- 把 bin 路径加入
PATH：echo 'export PATH="/opt/homebrew/opt/mysql@5.7/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc（M 系芯片路径是/opt/homebrew，Intel 是/usr/local） - 启动服务需显式调用：
brew services start mysql@5.7；检查状态用brew services list | grep mysql@5.7 - 首次启动后，必须运行
mysql_secure_installation设置 root 密码，否则默认无密码且不安全
另外，编译其他依赖 MySQL 的项目时，可能还需设置：export LDFLAGS="-L/opt/homebrew/opt/mysql@5.7/lib" 和 export CPPFLAGS="-I/opt/homebrew/opt/mysql@5.7/include" —— 这点常被跳过，导致后续构建失败。
多版本共存时的冲突风险
如果你同时装了 mysql@5.7 和默认的 mysql（即 8.0+），它们的 socket 文件、数据目录、默认端口（都是 3306）会冲突。不能同时 brew services start 两个。
- 建议只启用一个版本的服务，另一个用
--socket或--port显式指定参数启动（例如：/opt/homebrew/opt/mysql@5.7/bin/mysqld_safe --datadir=/opt/homebrew/var/mysql57 --port=3307） - 连接时也必须对应：用
mysql -P3307 -uroot连 5.7 实例，别误连到 8.0 默认端口
真正麻烦的不是安装那几步，而是禁用机制 + 依赖链禁用 + keg-only 路径 + 多版本端口/sock 冲突——这四层叠加，少做一步就卡住。
