OSX下Homebrew将Postgres11升级至13时,数据库升级失败报找不到postgis-2.5文件
Postgres 11升级13过程中Postgis依赖缺失、连接异常的处理方案
问题核心
升级失败的本质原因是:原有Postgres 11的数据库中安装了PostGIS 2.5扩展,当前Homebrew环境仅保留了适配Postgres13的PostGIS 3.0动态库,导致升级流程调用的pg_dump读取旧库扩展元数据时找不到对应版本的so文件;而psql连接失败是多版本Postgres并行安装过程中,服务状态、套接字路径、版本匹配错位导致的,并非服务真的正常运行。
分步操作流程
第一步:清理多版本Postgres的服务残留,解决连接异常
- 执行命令停止所有Postgres相关服务:
brew services stop postgresql@13 postgresql@11 - 检查5432端口的残留进程,对没停干净的进程直接终止,避免残留进程占用套接字/端口导致后续连接失败:
lsof -i :5432 - 手动启动Postgres11版本的服务,确保旧库可正常加载,才能处理库内的扩展依赖问题:
brew services start postgresql@11 - 验证连接:执行
psql -h /tmp -d postgres,确认能正常登录数据库。
- 执行命令停止所有Postgres相关服务:
第二步:临时补全PostGIS 2.5的依赖文件,匹配旧库需求
- 安装适配Postgres11的历史版本PostGIS:
brew install postgis@2.5 - 查找安装完成后生成的
postgis-2.5.so动态文件路径:find /usr/local/Cellar/postgis@2.5 -name "postgis-2.5.so" - 按照之前查询到的
$libdir路径(即/usr/local/lib/postgresql),给动态文件创建软链接,让pg_dump能正常读取:ln -s <上一步查到的so文件完整路径> /usr/local/lib/postgresql/postgis-2.5.so - 注意:不要覆盖、替换现有PostGIS 3.0的动态文件,临时补全旧版本依赖仅用于旧库导出,不影响新版本功能
- 回到Postgres11的连接会话中,执行
SELECT postgis_version();,确认数据库能正常识别PostGIS扩展,没有报文件缺失的错误。
- 安装适配Postgres11的历史版本PostGIS:
第三步:执行数据库升级流程
- 停止Postgres11版本的服务:
brew services stop postgresql@11 - 启动Postgres13版本的服务:
brew services start postgresql@13 - 重新执行数据库升级命令:
brew postgresql-upgrade-database,此时pg_dump导出旧库、导入新库的全流程不会再报PostGIS文件缺失的错误。 - 升级完成后,连接到Postgres13的数据库,将库内的PostGIS扩展正式升级到3.0版本:
ALTER EXTENSION postgis UPDATE;
- 停止Postgres11版本的服务:
第四步:清理临时依赖
升级完成确认所有数据库功能正常后,可以卸载临时安装的PostGIS 2.5版本,避免版本混乱:brew uninstall postgis@2.5
常见踩坑提醒
brew services list显示服务运行但psql连不上,本质是多版本并行安装时的套接字路径错位:Homebrew安装的不同版本Postgres默认会共用/tmp下的unix套接字,切换版本前一定要完全停止所有相关进程,不要只靠brew的服务状态判断运行情况- 不要直接删除旧库中的PostGIS扩展再跑升级流程,会导致空间数据丢失,必须先补全对应版本的扩展依赖,正常导出旧数据后再完成新版本扩展升级
内容的提问来源于stack exchange,提问作者Richard
相关产品推荐
相关产品推荐

