PostgreSQL 12 + PostGIS 3.4.2 完整部署+迁移+数据恢复避坑指南（新手可复制，全程无报错）

环境说明核心前提必看本次实操目标搭建可正常运行的GIS数据库环境完成跨服务器数据库拆分迁移恢复已有空间数据备份确保PostGIS空间功能、索引全部可用具体环境如下操作系统Windows适配所有Windows系统Win10/11通用本次涉及3台Windows服务器、1台Linux业务服务器PostgreSQL版本12.17稳定版适配PostGIS 3.4.2所有服务器统一版本避免迁移兼容问题PostGIS版本3.4.2针对PostgreSQL 12专用版严格匹配PG版本避免扩展安装失败数据库相关目标数据库gansueqwin用于存储GIS业务数据备份文件D:\gansueqwin_backup.dump含空间数据表、索引、约束、PostGIS相关函数服务器角色迁移场景补充67服务器原数据库服务器Windows已部署PostgreSQL 12.17PostGIS 3.4.2承载gansueqwin66业务用和gansueq40主力机用两个库32服务器新数据库服务器Windows需全新部署环境专用承载gansueqwin库仅给66服务器使用66服务器业务服务器WindowsJava GIS项目需切换数据库连接至32服务器40服务器主力业务服务器LinuxJava项目继续关联67服务器gansueq库全程不改动避免影响主力业务通用配置数据库统一账号postgres密码postgres2024减少配置复杂度可后续修改PostgreSQL默认端口5432二、全程实操步骤部署迁移恢复避坑重点标注第一部分32服务器基础环境部署PostgreSQL 12.17 PostGIS 3.4.2第一步PostgreSQL 12.17 安装基础环境避坑关键下载PostgreSQL 12.17安装包PostgreSQL官网下载链接或可信镜像安装路径选择纯英文路径本次路径D:\pushServer\postgresql避免中文路径导致后续报错。安装过程中设置postgres管理员密码务必牢记后续登录、操作都需要端口默认5432无需修改。取消勾选“Stack Builder”无需额外安装组件减少冗余避免冲突完成安装。⚠️ 避坑点安装路径绝对不能含中文、特殊字符密码建议设置简单易记如postgres2024后续可修改避免忘记密码导致无法登录这也是PostgreSQL 12部署中最易忽略的错误。第二步创建目标数据库gansueqwin安装完成后打开CMD管理员身份进入PostgreSQL的bin目录执行以下命令创建数据库并授权cd D:\pushServer\postgresql\binpsql -U postgres-- 登录后执行创建数据库命令CREATE DATABASE gansueqwin;-- 给postgres用户授予该库所有权限避免后续操作权限不足GRANT ALL PRIVILEGES ON DATABASE gansueqwin TO postgres;执行成功后会分别显示“CREATE DATABASE”和“GRANT”说明数据库创建并授权成功此步骤核心是确保postgres用户拥有完整权限避免后续PostGIS扩展安装、数据恢复时出现权限不足报错。第三步PostGIS 3.4.2 安装最易踩坑版本匹配是核心核心原则PostGIS版本必须与PostgreSQL版本严格匹配这是PostGIS 3.4.2安装的核心要点本次PostgreSQL 12.17对应PostGIS 3.4.2for PostgreSQL 12 x64可通过两种方式安装二选一推荐方式二适配迁移场景避免出现版本不兼容报错。方式一直接安装全新部署无迁移需求适用卸载错误版本若之前装错过如果之前安装过PostGIS 3.4.2for PostgreSQL 13必须先卸载控制面板→卸载程序找到带“PostgreSQL 13”的PostGIS组件右键卸载卸载后重启电脑避免残留文件导致冲突这是PostGIS扩展安装失败的常见原因之一。正确安装PostGIS 3.4.2for PostgreSQL 12运行安装包勾选以下组件严格对照避免报错✅ PostGIS Bundle核心主包必勾不勾等于未安装❌ Create spatial database不勾自动创建模板库易报错后续手动安装扩展更稳✅ Register PROJ_LIB Env Var必勾坐标转换必备不勾会导致空间功能失效✅ Register GDAL_DATA Env Var必勾栅格/矢量数据处理必备✅ Enable Key GDAL Drivers必勾支持常用GIS格式如Shapefile、TIFF❌ Enable All GDAL Drivers不勾避免冗余和安全风险✅ Allow Out-db Rasters推荐勾提升大栅格数据处理效率✅ Register SSL Bundle推荐勾生产环境远程加密连接必备安装过程中弹窗“Would you like to register PROJ_LIB...”直接点击“是(Y)”自动配置环境变量无需手动操作。方式二从67服务器复制插件迁移场景适用无需重新下载若67服务器已部署相同版本的PostGIS 3.4.2可直接复制插件文件到32服务器高效快捷步骤如下在67服务器找到PostGIS插件核心目录复制对应文件插件配置文件目录C:\Program Files\PostgreSQL\12\share\extension\复制所有以“postgis”开头的文件如postgis--3.4.2.sql、postgis.control等。动态库文件目录C:\Program Files\PostgreSQL\12\lib\复制所有以“postgis”开头的.dll文件如postgis-3.dll、postgis_topology-3.dll等。将复制的文件粘贴到32服务器对应目录32的PostgreSQL安装路径为D:\pushServer\postgresql\插件配置文件粘贴到D:\pushServer\postgresql\share\extension\覆盖原有同名文件即可。动态库文件粘贴到D:\pushServer\postgresql\lib\覆盖原有同名文件即可。重启32服务器的PostgreSQL服务按WinR输入services.msc找到postgresql-x64-12右键重启插件文件立即生效。⚠️ 避坑点版本不匹配会直接导致扩展安装失败报错“PostGIS built for PostgreSQL 13 cannot be loaded in PostgreSQL 12”这是PostGIS 3.4.2安装最易踩的坑务必确认安装包/插件文件是针对PostgreSQL 12的版本解决PostGIS扩展安装失败问题。第四步安装PostGIS扩展启用空间功能必做PostGIS安装完成后需手动给目标数据库gansueqwin安装扩展才能支持空间数据存储和查询执行以下命令cd D:\pushServer\postgresql\bin-- 安装核心空间扩展psql -U postgres -d gansueqwin -c CREATE EXTENSION postgis;-- 安装栅格数据支持扩展GIS业务必备psql -U postgres -d gansueqwin -c CREATE EXTENSION postgis_raster;-- 安装拓扑扩展可选根据业务需求psql -U postgres -d gansueqwin -c CREATE EXTENSION postgis_topology;执行成功后会显示“CREATE EXTENSION”说明扩展安装成功此步骤是启用PostGIS空间功能的关键未执行此步骤会导致后续数据恢复时GIS表无法创建。验证扩展版本确认安装正确psql -U postgres -d gansueqwin -c SELECT postgis_version();返回“3.4 USE_GEOS1 USE_PROJ1 USE_STATS1”说明PostGIS 3.4.2安装成功且与PostgreSQL 12.17兼容。第二部分跨服务器数据库迁移67→32拆分部署第五步在67服务器备份gansueqwin数据库核心备份时需包含表结构、数据、PostGIS相关函数和索引确保备份文件完整避免迁移后数据缺失这是PostgreSQL跨服务器迁移的核心前提。打开67服务器的CMD以管理员身份运行进入PostgreSQL的bin目录默认路径若自定义路径需调整cd C:\Program Files\PostgreSQL\12\bin执行备份命令直接复制无需修改输入postgres密码即可pg_dump -h 10.62.210.67 -p 5432 -U postgres -F c -b -v -f D:\gansueqwin_backup.dump gansueqwin校验备份备份完成后去D盘查看gansueqwin_backup.dump文件确认文件大小正常、无报错。第六步将备份文件传输至32服务器通过远程桌面复制、共享文件夹等方式将67服务器D盘的gansueqwin_backup.dump文件复制到32服务器的D盘根目录便于后续恢复时查找避免路径过长导致报错这是PostgreSQL数据迁移中确保备份文件可用的基础步骤。第七步32服务器重建数据库清理环境确保恢复无冲突若之前已创建gansueqwin库需先清理旧库避免残留数据冲突步骤如下此步骤可解决PostgreSQL数据库删除失败的相关问题打开32服务器的SQL Shell (psql)输入postgres密码登录切换到默认postgres库避免无法删除当前连接的库\c postgres强制断开gansueqwin库的所有连接若库已存在避免删除失败SELECT pg_terminate_backend(pg_stat_activity.pid) FROM pg_stat_activity WHERE pg_stat_activity.datname gansueqwin;删除旧库若存在重建gansueqwin数据库DROP DATABASE IF EXISTS gansueqwin; CREATE DATABASE gansueqwin; -- 重新授权避免权限不足 GRANT ALL PRIVILEGES ON DATABASE gansueqwin TO postgres;切换到新创建的gansueqwin库重新安装PostGIS扩展确保扩展与库绑定\c gansueqwin; CREATE EXTENSION postgis; CREATE EXTENSION postgis_raster; CREATE EXTENSION postgis_topology