Mac用Homebrew安装PSQL后启动报exited with 5错误怎么解决？

核心原因说明 #

该报错为Mac设备通过Homebrew安装PostgreSQL后的常见启动失败问题，通常由目录权限异常、旧版launchctl配置冲突、数据目录损坏三类原因导致，可按以下步骤逐一排查修复：

分步修复流程 #

• 第一步：终止所有后台运行的PostgreSQL进程，避免端口/资源占用
  执行命令：

  sudo pkill -u postgres
  

  提示无匹配进程可直接进入下一步
• 第二步：修复Homebrew和PostgreSQL数据目录权限
  先执行通用权限修复命令：

  sudo chown -R $(whoami) $(brew --prefix)/*
  

  再根据芯片架构执行对应命令：
  • M系列芯片Mac：

    sudo chown -R $(whoami) /opt/homebrew/var/postgres/
    

  • Intel芯片Mac：

    sudo chown -R $(whoami) /usr/local/var/postgres/
    

• 第三步：清理旧的launchctl启动配置缓存
  执行命令：

  launchctl remove homebrew.mxcl.postgresql
  rm -f ~/Library/LaunchAgents/homebrew.mxcl.postgresql.plist
  

• 第四步：重启PostgreSQL服务验证
  执行命令：

  brew services restart postgresql
  

  执行brew services list查看状态，postgresql对应行显示started即为启动成功，可通过psql postgres验证数据库连接。

极端情况处理 #

上述步骤执行后仍启动失败的，判定为数据目录损坏，可执行以下命令重建数据目录（注意：该操作会清空所有现有PostgreSQL数据，有数据留存需求请提前备份对应架构下的postgres目录）：

• M系列芯片Mac：

  rm -rf /opt/homebrew/var/postgres
  initdb /opt/homebrew/var/postgres -E UTF8
  brew services restart postgresql
  

• Intel芯片Mac：

  rm -rf /usr/local/var/postgres
  initdb /usr/local/var/postgres -E UTF8
  brew services restart postgresql
  

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