MacOS下Homebrew安装PostgreSQL连接报Operation not permitted错误

该报错属于权限拦截类问题，和常见的文件不存在报错根因完全不同，按以下优先级逐一排查即可： #

1. 修复数据目录归属权限 #

Homebrew部署的PostgreSQL默认数据目录路径随芯片架构不同有区别：

• Intel芯片Mac：/usr/local/var/postgres
• Apple Silicon芯片Mac：/opt/homebrew/var/postgres
  PostgreSQL服务进程要求数据目录的所有者必须为服务启动用户（即当前登录系统的普通用户，不能是root），权限不匹配时就会抛出操作不允许错误。
  先执行对应命令检查目录归属：

# Intel芯片执行
ls -la /usr/local/var/ | grep postgres

# Apple Silicon芯片执行
ls -la /opt/homebrew/var/ | grep postgres

如果输出中postgres目录的所有者不是你的当前系统用户名，执行对应命令修复权限：

# Intel芯片执行
sudo chown -R $(whoami) /usr/local/var/postgres

# Apple Silicon芯片执行
sudo chown -R $(whoami) /opt/homebrew/var/postgres

修复完成后重启服务再尝试连接：
brew services restart postgresql #

2. 放行macOS全磁盘访问权限 #

macOS 10.14及以上版本的隐私保护机制会默认拦截未授权进程访问程序数据目录，即使文件权限配置正确也会拦截并返回Operation not permitted。
按以下步骤配置：

• 打开「系统设置」→「隐私与安全性」→「全磁盘访问」
• 在应用列表中找到你日常使用的终端程序（系统自带Terminal、iTerm2、Warp等），勾选开启权限
• 完全退出终端程序后重新打开，重启PostgreSQL服务后重试连接
  *如果配置后仍报错，找到PostgreSQL可执行文件路径（Intel为/usr/local/bin/postgres，Apple Silicon为/opt/homebrew/bin/postgres），将其也加入全磁盘访问允许列表。

3. 移除系统文件隔离标记 #

如果是安装完成后第一次启动就触发该报错，大概率是Homebrew下载的程序文件被macOS GateKeeper加了隔离属性，执行对应命令移除标记即可：

# Intel芯片执行
sudo xattr -d com.apple.quarantine /usr/local/Cellar/postgresql*/*/bin/*

# Apple Silicon芯片执行
sudo xattr -d com.apple.quarantine /opt/homebrew/Cellar/postgresql*/*/bin/*

执行完成后重启PostgreSQL服务重试。 #

4. 数据目录损坏时的重建方案 #

如果以上三种方案都无法解决问题，说明数据目录下的系统表文件已经损坏，按以下步骤重建：

1. 先停止运行中的PostgreSQL服务：brew services stop postgresql
2. 备份旧数据目录（不要直接删除，避免存量数据丢失）：

   # Intel芯片执行
   mv /usr/local/var/postgres /usr/local/var/postgres_backup
   
   # Apple Silicon芯片执行
   mv /opt/homebrew/var/postgres /opt/homebrew/var/postgres_backup
   

3. 重新初始化数据库：

   # Intel芯片执行
   initdb -D /usr/local/var/postgres
   
   # Apple Silicon芯片执行
   initdb -D /opt/homebrew/var/postgres
   

4. 启动服务：brew services start postgresql
   *如果旧数据目录中有业务数据，初始化完成后通过逻辑备份恢复即可，不要直接拷贝覆盖pg_filenode.map这类系统表文件，会造成元数据永久错乱。

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