Mac M2上为PostgreSQL 16启用PostGIS扩展遇阻求助

核心问题分析 #

你遇到的问题根源有两个：

1. 安装方式不统一：官网安装包的PostgreSQL和brew安装的PostGIS分属不同包管理体系，路径不互通，导致PostgreSQL无法识别brew安装的扩展文件。
2. 版本不匹配：PostgreSQL 16要求PostGIS 3.4.0及以上版本，brew默认安装的3.3.4版本不兼容。

解决方案一：统一用brew安装（推荐，最省心） #

步骤1：卸载官网的PostgreSQL 16 #

• 运行官方卸载脚本：

  /Library/PostgreSQL/16/uninstall-postgresql.app/Contents/MacOS/uninstall-postgresql
  

• 手动清理残留目录（可选）：

  sudo rm -rf /Library/PostgreSQL/16
  

步骤2：brew安装兼容版本的PostgreSQL和PostGIS #

• 更新brew索引：

  brew update
  

• 安装PostgreSQL 16：

  brew install postgresql@16
  

• 安装适配的PostGIS（brew会自动匹配PostgreSQL 16对应的3.4.0+版本）：

  brew install postgis
  

• 启动PostgreSQL服务：

  brew services start postgresql@16
  

• 验证安装：进入psql执行

  CREATE EXTENSION postgis;
  

  无报错则成功。

解决方案二：给官网PostgreSQL适配brew的PostGIS（不推荐，易出后续问题） #

如果不想卸载现有官网PostgreSQL，可以手动复制扩展文件到PostgreSQL的搜索路径：

步骤1：安装兼容PostgreSQL 16的PostGIS版本 #

• 先卸载旧版PostGIS：

  brew uninstall postgis
  

• 安装适配3.4.0+版本的PostGIS（brew会自动拉取兼容PostgreSQL 16的版本）：

  brew install postgis
  

步骤2：复制扩展文件到PostgreSQL目录 #

• 找到brew安装的PostGIS扩展文件目录（替换3.4.x为实际安装的版本号）：

  /opt/homebrew/Cellar/postgis/3.4.x/share/postgresql/extension/
  

• 将该目录下所有文件（postgis.control、postgis--*.sql等）复制到官网PostgreSQL的扩展目录：

  sudo cp /opt/homebrew/Cellar/postgis/3.4.x/share/postgresql/extension/* /Library/PostgreSQL/16/share/postgresql/extension/
  

• 复制PostGIS动态链接库：

  sudo cp /opt/homebrew/Cellar/postgis/3.4.x/lib/postgresql/postgis-3.so /Library/PostgreSQL/16/lib/postgresql/
  

步骤3：配置并重启PostgreSQL #

• 编辑postgresql.conf（路径：/Library/PostgreSQL/16/data/postgresql.conf），确保添加：

  shared_preload_libraries = 'postgis'
  

• 重启PostgreSQL服务：

  sudo /Library/PostgreSQL/16/bin/pg_ctl restart -D /Library/PostgreSQL/16/data
  

• 进入psql执行CREATE EXTENSION postgis;验证。

额外说明 #

• 不要在shared_preload_libraries里添加PostGIS除非你确定库文件路径正确，否则会导致PostgreSQL启动失败。
• 最新版PostgreSQL已移除Stack Builder，无需再尝试该途径。

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