M1 Mac通过Homebrew安装MariaDB提示post-install步骤执行失败

适用场景：M1系列芯片Mac、Homebrew作为包管理器、曾安装过MySQL、清理常规MySQL残留后执行brew install mariadb仍提示post-install步骤失败。

修复步骤 #

• 清理占用端口和文件锁的残留进程
  3306端口、mysql.sock套接字文件被残留的MySQL/半初始化MariaDB进程占用是最高发的失败原因，先执行命令排查占用：

  lsof -i :3306
  

  若命令返回PID列的进程号，直接执行kill -9 对应PID强制结束进程，例如返回PID为2456就执行kill -9 2456。

• 清理全量残留文件
  常规卸载命令会遗漏配置文件、启动项、临时套接字文件，依次执行以下命令彻底删除：

  brew uninstall --force mysql mariadb
  sudo rm -rf /opt/homebrew/var/mysql
  sudo rm -rf /opt/homebrew/bin/mysql*
  sudo rm -rf /opt/homebrew/Cellar/mysql
  sudo rm -rf /opt/homebrew/etc/my.cnf
  sudo rm -rf /opt/homebrew/var/run/mysqld
  sudo rm -rf /tmp/mysql.sock*
  sudo rm -rf ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist
  sudo rm -rf /Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist
  

• 修复Homebrew目录权限
  M1芯片Mac的Homebrew安装在/opt/homebrew路径下，之前如果误用sudo执行brew命令，会导致目录属主异常，post-install阶段无写入权限：

  mkdir -p /opt/homebrew/var/mysql
  sudo chown -R $(whoami):admin /opt/homebrew/var/mysql
  sudo chmod -R 755 /opt/homebrew/var/mysql
  

• 重新执行安装和后置步骤
  注意：所有brew相关命令禁止加sudo，否则会再次打乱目录权限

  brew install mariadb
  brew postinstall mariadb
  

验证与启动 #

post-install执行无报错后，启动MariaDB服务：

brew services start mariadb

执行mariadb -u root能正常进入数据库命令行即修复完成，默认本地root登录无密码。

排查辅助 #

如果以上步骤执行后仍失败，直接查看post-install的详细日志定位具体错误：

cat /opt/homebrew/Logs/Homebrew/mariadb/post_install*.log

日志会明确标注失败原因，常见的有剩余残留文件、磁盘空间不足、依赖版本冲突等。

内容的提问来源于stack exchange，提问作者roomdoor