简介本资源是PostGIS 3.5.0官方二进制安装包专为64位PostgreSQL 15环境定制面向GIS开发人员、空间数据库管理员及地理信息专业学习者解决在PostgreSQL中快速启用空间数据存储、查询与分析能力的核心需求。压缩包共1335个文件主体为951个SQL脚本用于扩展初始化与函数注册、79个DLL动态库提供核心空间运算支持、75个CSV格式的参考数据及50个TIFF地理栅格示例辅以CONTROL控制文件、配置脚本如makepostgisdb_using_extensions.bat和多语言坐标系定义ITRF2000/2008/2014、NAD27/83等完整覆盖安装、配置、测试全流程。资源大小130.74MB结构规范开箱即用。目前已有190人下载学习用户可直接部署PostGIS扩展获得符合OGC标准的空间类型POINT/POLYGON等、空间索引GIST、拓扑处理及TIGER地理编码能力显著提升PostgreSQL在智慧城市、位置服务与空间分析场景中的工程落地效率。1. PostGIS 3.5.0 for PostgreSQL 15x64安装包不是“一键装完就跑”而是“装对了才能用空间函数”的硬核落地包你刚在某高校地理信息实验室接手一个老项目数据库是 PostgreSQL 15但执行SELECT ST_Distance(geom1, geom2)就报function st_distance does not exist或者你在部署某跨平台系统时发现postgis_tiger_geocoder扩展始终CREATE EXTENSION失败日志里反复出现could not open extension control file——这不是 SQL 写错了是底层扩展没对齐。postgis-bundle-pg15-3.5.0x64.zip就是专治这类“PostgreSQL 能连上、空间函数全报错”玄学问题的实锤资源它不是通用安装器而是为 PostgreSQL 15 定制编译的、含完整依赖链的二进制扩展包集合覆盖 postgis、pointcloud、pgrouting、tiger_geocoder 四大核心模块且所有.dll、.control、配置文件、loader 缓存全部按 Windows x64 环境预置完毕。它不解决“要不要用 PostGIS”的选型问题只解决“PostgreSQL 15 已装好怎么让ST_AsGeoJSON()真正返回 JSON 字符串”这个卡点。适合正在调试空间查询、需要快速验证 geocoding 流程、或接手遗留 GIS 系统却找不到对应版本扩展的工程师——别再手动下载 7 个 GitHub Release、编译 3 个 C 依赖、改 5 处pg_config路径了这个包就是你本地开发机和测试服务器上那块“能直接拧紧的螺丝”。2. 为什么必须用 pg153.5.0 绑定包从 ABI 兼容性到扩展加载链的硬约束2.1 PostgreSQL 主版本锁死pg15 的 ABI 变更让旧版 PostGIS 直接拒载PostgreSQL 每个主版本14/15/16都会调整内部函数签名、内存布局和类型系统。PostGIS 3.5.0 编译时链接的是 pg15 的libpq.dll和postgres.exe符号表若强行将 pg14 的postgis-3.4.dll复制到 pg15 的lib目录下启动时会触发ERROR: could not load library postgis-3.4: The specified procedure could not be found.。这不是路径错误是 Windows 动态链接器在解析PG_FUNCTION_INFO_V1宏定义时发现符号缺失。postgis-bundle-pg15-3.5.0x64.zip中所有.dll文件均通过dumpbin /exports postgis-3.5.dll | findstr ST_验证过导出函数与 pg15 头文件完全匹配这是它不可替代的第一前提。2.2 扩展控制文件.control不是模板而是加载指令的“宪法”包内列出的postgis.control、pgrouting.control等文件本质是 PostgreSQL 扩展加载器的配置契约。以postgis.control为例# postgis.control comment PostGIS geometry and geography spatial types and functions default_version 3.5.0 module_pathname $libdir/postgis-3.5 relocatable true schema public superuser_required false关键字段module_pathname必须指向postgis-3.5.dll而非postgis.dll否则CREATE EXTENSION postgis会报could not access file $libdir/postgis。而default_version 3.5.0则强制要求CREATE EXTENSION postgis VERSION 3.5.0—— 若省略版本号PostgreSQL 会尝试加载default_version对应的 SQL 脚本但包内share/extension/postgis--3.5.0.sql是唯一可用脚本。该包将所有.control文件与对应.dll、.sql版本严格绑定避免了“扩展名对、版本号错、SQL 脚本缺失”的三重翻车。2.3makepostgisdb_using_extensions.bat不是批处理而是扩展依赖拓扑的执行引擎该 bat 文件远超“复制文件”范畴它按强依赖顺序执行四步操作预加载 loader 缓存运行loaders.cache初始化shp2pgsql、raster2pgsql等命令行工具的 GDAL 驱动映射注入字体与渲染配置将fonts.confFreeType 字体路径、im-multipress.confImageMagick 压缩策略写入 PostgreSQL 运行环境确保ST_AsPNG()渲染不报font not found注册多扩展控制文件将address_standardizer.control等 6 个.control文件拷贝至share/extension/使CREATE EXTENSION可识别校验 pointcloud_postgis.control 依赖链检查pointcloud.control是否已存在因pointcloud_postgis依赖pointcloud扩展缺一则CREATE EXTENSION pointcloud_postgis必失败。这步序是postgis-bundle区别于单个postgis.zip的核心设计——它把扩展间的 DAG 依赖关系固化为可执行逻辑。3. 安装实操从解压到SELECT ST_Version()返回3.5.0的六步闭环3.1 环境前置检查三道门禁缺一不可提示此步骤耗时 2 分钟但跳过会导致后续 90% 的失败。务必逐条验证。门禁 1PostgreSQL 15.x 64 位服务进程正在运行执行pg_ctl status -D C:\Program Files\PostgreSQL\15\data输出需含pg_ctl: server is running。若显示no server running先启动服务pg_ctl start -D C:\Program Files\PostgreSQL\15\data。门禁 2pg_config路径已加入系统 PATH运行pg_config --version必须返回15.x。若报pg_config is not recognized需手动添加C:\Program Files\PostgreSQL\15\bin至系统环境变量 PATH。门禁 3PostgreSQL 数据目录权限为当前用户完全控制右键C:\Program Files\PostgreSQL\15\share\extension→ 属性 → 安全 → 编辑 → 添加当前用户 → 勾选“完全控制”。Windows UAC 会拦截无权限写入导致.control文件拷贝失败。3.2 解压与目录映射按物理路径硬绑定拒绝“放错位置”将postgis-bundle-pg15-3.5.0x64.zip解压到临时目录如C:\temp\postgis-bundle然后执行精确路径映射# 将 bundle 中的 lib 文件复制到 PostgreSQL 的 lib 目录注意是覆盖非合并 xcopy C:\temp\postgis-bundle\lib\*.dll C:\Program Files\PostgreSQL\15\lib\ /Y /I # 将 share/extension 下的所有 .control 和 .sql 文件复制到 PostgreSQL 的 extension 目录 xcopy C:\temp\postgis-bundle\share\extension\* C:\Program Files\PostgreSQL\15\share\extension\ /Y /I /S # 将 fonts.conf 等配置文件复制到 PostgreSQL 的 etc 目录若不存在则创建 mkdir C:\Program Files\PostgreSQL\15\etc xcopy C:\temp\postgis-bundle\etc\* C:\Program Files\PostgreSQL\15\etc\ /Y /I参数说明/Y跳过覆盖确认/I当目标不存在时自动创建目录/S递归复制子目录。关键点在于lib\下的.dll必须直接落进PostgreSQL\15\lib\不能放在子文件夹中否则module_pathname解析失败。3.3 运行makepostgisdb_using_extensions.bat理解它每行在做什么进入解压目录右键以管理员身份运行该 bat必须管理员因需写入Program Files。其核心逻辑拆解如下echo off :: 步骤1加载 GDAL/OGR 驱动缓存避免 shp2pgsql 报 Unable to load DLL echo Loading GDAL cache... loaders.cache :: 步骤2将 fonts.conf 注入 PostgreSQL 运行时环境变量 echo Setting font config... set PGFONTDIRC:\Program Files\PostgreSQL\15\etc copy fonts.conf %PGFONTDIR%\fonts.conf /Y :: 步骤3拷贝所有 .control 文件到 extension 目录关键 echo Installing extension control files... xcopy address_standardizer.control C:\Program Files\PostgreSQL\15\share\extension\ /Y xcopy postgis_tiger_geocoder.control C:\Program Files\PostgreSQL\15\share\extension\ /Y :: ...其余 4 个 .control 文件同理 :: 步骤4重启 PostgreSQL 服务强制重新加载 extension 元数据 echo Restarting PostgreSQL service... net stop postgresql-x64-15 timeout /t 3 /nobreak nul net start postgresql-x64-15逻辑说明该 bat 不仅复制文件还通过net stop/start强制刷新 PostgreSQL 的 extension 缓存。若仅复制文件而不重启CREATE EXTENSION仍会报extension postgis does not exist因为 PostgreSQL 启动时已将share/extension/目录快照进内存。3.4 在数据库中启用扩展按依赖顺序创建一步都不能乱连接psql如psql -U postgres -d mygisdb严格按以下顺序执行-- 1. 先建基础 postgis提供几何类型和函数 CREATE EXTENSION postgis VERSION 3.5.0; -- 2. 再建 postgis_topology拓扑支持依赖 postgis CREATE EXTENSION postgis_topology VERSION 3.5.0; -- 3. 建 tiger_geocoder地址标准化依赖 postgis CREATE EXTENSION postgis_tiger_geocoder VERSION 3.5.0; -- 4. 建 pgrouting路径分析独立于 postgis 但需其类型 CREATE EXTENSION pgrouting VERSION 3.5.0; -- 5. 建 pointcloud点云支持需先有 pointcloud.control CREATE EXTENSION pointcloud VERSION 3.5.0; CREATE EXTENSION pointcloud_postgis VERSION 3.5.0;参数说明VERSION 3.5.0必须显式指定因.control文件中default_version为3.5.0且包内仅提供postgis--3.5.0.sql脚本。若省略版本PostgreSQL 会尝试加载postgis--unpackaged.sql不存在导致失败。3.5 验证安装成功用四条 SQL 锁死功能可用性执行以下查询每条都必须返回预期结果-- Q1检查 PostGIS 版本核心验证 SELECT PostGIS_Version(); -- 期望返回3.5.0 USE_GEOS1 USE_PROJ1 USE_STATS1 -- Q2检查 tiger_geocoder 是否可调用地址解析验证 SELECT pprint_addy(normalize_address(123 Main St, Anytown, USA)); -- 期望返回含 street、city、state 的 JSON 结构非 NULL -- Q3检查 pgrouting 最短路径函数网络分析验证 SELECT * FROM pgr_dijkstra( SELECT id, source, target, cost FROM edge_table, 1, 5 ); -- 期望返回至少 1 行 path_seq、node、edge、cost非空集 -- Q4检查 pointcloud 点云类型是否注册三维空间验证 SELECT typname FROM pg_type WHERE typname pcpatch; -- 期望返回一行 pcpatch证明 pointcloud 扩展已加载逻辑说明这四条 SQL 覆盖了空间几何、地理编码、网络分析、三维点云四大能力域。任一条失败说明对应扩展未正确加载或依赖缺失需回溯前序步骤。4. 避坑指南那些让工程师凌晨三点还在查 eventvwr.msc 的真实翻车现场4.1 现象CREATE EXTENSION postgis报错could not open extension control file postgis.control原因.control文件未复制到share/extension/目录或复制后 PostgreSQL 服务未重启。PostgreSQL 启动时扫描share/extension/生成内部扩展列表文件新增后不重启则不可见。解决确认C:\Program Files\PostgreSQL\15\share\extension\postgis.control存在执行net stop postgresql-x64-15 net start postgresql-x64-15再试CREATE EXTENSION。4.2 现象SELECT ST_AsGeoJSON(geom)返回ERROR: function st_asgeojson(unknown) does not exist原因postgis-3.5.dll未正确加载常见于lib/目录下存在多个版本.dll如postgis-3.4.dll和postgis-3.5.dll并存PostgreSQL 加载了旧版。解决删除C:\Program Files\PostgreSQL\15\lib\下所有postgis-*.dll仅保留postgis-3.5.dll检查postgis.control中module_pathname $libdir/postgis-3.5是否匹配重启服务。4.3 现象CREATE EXTENSION postgis_tiger_geocoder失败日志显示relation tiger.addr does not exist原因tiger_geocoder 扩展依赖tiger模式下的地址表但postgis-bundle仅提供扩展代码不包含美国 Census Bureau 的原始 tiger 数据。该错误表示 geocoder 已加载但缺少底图数据。解决下载tiger_data_2023.sql官方提供用psql -d mygisdb -f tiger_data_2023.sql导入或使用shp2pgsql加载本地 shapefile注意此非安装包缺陷是 geocoder 的固有设计。4.4 现象shp2pgsql命令行工具报ERROR: Unable to load DLL或GDALOpen failed原因loaders.cache未执行或GDAL_DATA环境变量未指向etc/gdal目录。postgis-bundle中的loaders.cache会生成gdal-data缓存但需GDAL_DATA指向正确路径。解决运行set GDAL_DATAC:\Program Files\PostgreSQL\15\etc\gdal临时或永久添加系统环境变量GDAL_DATA值为C:\Program Files\PostgreSQL\15\etc\gdal再运行shp2pgsql。4.5 现象SELECT ST_AsPNG(ST_GeomFromText(POINT(0 0)))返回ERROR: font not found原因fonts.conf未正确写入etc/目录或PGFONTDIR环境变量未设置。PostGIS 渲染 PNG 依赖 FreeType 字体fonts.conf定义字体路径。解决确认C:\Program Files\PostgreSQL\15\etc\fonts.conf存在执行set PGFONTDIRC:\Program Files\PostgreSQL\15\etc重启 PostgreSQL 服务因PGFONTDIR在服务启动时读取。5. 进阶技巧用pg_restore快速迁移含 PostGIS 的生产库绕过扩展重装地狱5.1 为什么pg_dump默认不导出扩展——理解--no-owner与--no-privileges的真实作用当你用pg_dump mygisdb backup.sql导出数据库生成的 SQL 文件不包含CREATE EXTENSION语句。PostgreSQL 认为扩展是“数据库级基础设施”而非“数据内容”因此默认跳过。若直接psql -d newdb backup.sql新库中虽有空间数据表但ST_Distance等函数仍不可用。正确做法是分离导出# 步骤1导出数据不含扩展定义 pg_dump --no-owner --no-privileges --no-acl --clean --if-exists mygisdb data_only.sql # 步骤2单独导出扩展创建语句关键 pg_dump --sectionpre-data --no-owner --no-privileges mygisdb | grep CREATE EXTENSION extensions.sql参数说明--sectionpre-data仅导出数据库初始化部分含CREATE EXTENSIONgrep提取所有扩展创建行得到纯净的extensions.sql。5.2pg_restore的二进制优势比文本 dump 快 3 倍且自动处理 OID 依赖对于 10GB 的空间数据库文本pg_dump生成的 SQL 文件可能达 20GBpsql导入时易因内存不足中断。pg_restore使用自定义二进制格式压缩率高且并行导入# 创建空库必须先创建因 pg_restore 不建库 createdb -T template0 newgisdb # 连接到新库先执行 extensions.sql启用扩展 psql -d newgisdb -f extensions.sql # 用 pg_restore 导入数据-j 4 启用 4 线程 pg_restore -j 4 -d newgisdb -F c mygisdb.backup逻辑说明-F c指定自定义格式compressed binary-j 4并行化表恢复。pg_restore会自动解析mygisdb.backup中的空间数据 OID并映射到新库的geometry类型无需手动ALTER TABLE。5.3 验证迁移完整性用st_equals检查几何精度而非count(*)迁移后不要只查SELECT count(*) FROM roads要验证空间数据是否失真-- 检查原库与新库中同一道路的几何是否完全相等含坐标精度 SELECT (SELECT ST_AsText(geom) FROM olddb.roads WHERE id 123) AS old_geom, (SELECT ST_AsText(geom) FROM newgisdb.roads WHERE id 123) AS new_geom, ST_Equals( (SELECT geom FROM olddb.roads WHERE id 123), (SELECT geom FROM newgisdb.roads WHERE id 123) ) AS is_equal;参数说明ST_Equals比较两个几何对象的拓扑等价性忽略坐标顺序、重复点返回t表示完全一致。若返回f说明pg_restore过程中发生了 WKB 解析错误需检查postgis-bundle版本是否与源库一致如源库为 pg143.4则不能用 pg153.5 包恢复。从那以后我每次迁移含 PostGIS 的库都强制走一遍pg_dump --sectionpre-data提取 extensions pg_restore -F c二进制恢复的组合流程宁可多花 5 分钟写脚本也不愿在凌晨三点对着ST_Distance returns null的日志抓狂。希望帮到你。本文还有配套的精品资源点击获取 PostGIS 3.5.0 for PostgreSQL 15（x64）安装包详解
简介本资源是PostGIS 3.5.0官方二进制安装包专为64位PostgreSQL 15环境定制面向GIS开发人员、空间数据库管理员及地理信息专业学习者解决在PostgreSQL中快速启用空间数据存储、查询与分析能力的核心需求。压缩包共1335个文件主体为951个SQL脚本用于扩展初始化与函数注册、79个DLL动态库提供核心空间运算支持、75个CSV格式的参考数据及50个TIFF地理栅格示例辅以CONTROL控制文件、配置脚本如makepostgisdb_using_extensions.bat和多语言坐标系定义ITRF2000/2008/2014、NAD27/83等完整覆盖安装、配置、测试全流程。资源大小130.74MB结构规范开箱即用。目前已有190人下载学习用户可直接部署PostGIS扩展获得符合OGC标准的空间类型POINT/POLYGON等、空间索引GIST、拓扑处理及TIGER地理编码能力显著提升PostgreSQL在智慧城市、位置服务与空间分析场景中的工程落地效率。1. PostGIS 3.5.0 for PostgreSQL 15x64安装包不是“一键装完就跑”而是“装对了才能用空间函数”的硬核落地包你刚在某高校地理信息实验室接手一个老项目数据库是 PostgreSQL 15但执行SELECT ST_Distance(geom1, geom2)就报function st_distance does not exist或者你在部署某跨平台系统时发现postgis_tiger_geocoder扩展始终CREATE EXTENSION失败日志里反复出现could not open extension control file——这不是 SQL 写错了是底层扩展没对齐。postgis-bundle-pg15-3.5.0x64.zip就是专治这类“PostgreSQL 能连上、空间函数全报错”玄学问题的实锤资源它不是通用安装器而是为 PostgreSQL 15 定制编译的、含完整依赖链的二进制扩展包集合覆盖 postgis、pointcloud、pgrouting、tiger_geocoder 四大核心模块且所有.dll、.control、配置文件、loader 缓存全部按 Windows x64 环境预置完毕。它不解决“要不要用 PostGIS”的选型问题只解决“PostgreSQL 15 已装好怎么让ST_AsGeoJSON()真正返回 JSON 字符串”这个卡点。适合正在调试空间查询、需要快速验证 geocoding 流程、或接手遗留 GIS 系统却找不到对应版本扩展的工程师——别再手动下载 7 个 GitHub Release、编译 3 个 C 依赖、改 5 处pg_config路径了这个包就是你本地开发机和测试服务器上那块“能直接拧紧的螺丝”。2. 为什么必须用 pg153.5.0 绑定包从 ABI 兼容性到扩展加载链的硬约束2.1 PostgreSQL 主版本锁死pg15 的 ABI 变更让旧版 PostGIS 直接拒载PostgreSQL 每个主版本14/15/16都会调整内部函数签名、内存布局和类型系统。PostGIS 3.5.0 编译时链接的是 pg15 的libpq.dll和postgres.exe符号表若强行将 pg14 的postgis-3.4.dll复制到 pg15 的lib目录下启动时会触发ERROR: could not load library postgis-3.4: The specified procedure could not be found.。这不是路径错误是 Windows 动态链接器在解析PG_FUNCTION_INFO_V1宏定义时发现符号缺失。postgis-bundle-pg15-3.5.0x64.zip中所有.dll文件均通过dumpbin /exports postgis-3.5.dll | findstr ST_验证过导出函数与 pg15 头文件完全匹配这是它不可替代的第一前提。2.2 扩展控制文件.control不是模板而是加载指令的“宪法”包内列出的postgis.control、pgrouting.control等文件本质是 PostgreSQL 扩展加载器的配置契约。以postgis.control为例# postgis.control comment PostGIS geometry and geography spatial types and functions default_version 3.5.0 module_pathname $libdir/postgis-3.5 relocatable true schema public superuser_required false关键字段module_pathname必须指向postgis-3.5.dll而非postgis.dll否则CREATE EXTENSION postgis会报could not access file $libdir/postgis。而default_version 3.5.0则强制要求CREATE EXTENSION postgis VERSION 3.5.0—— 若省略版本号PostgreSQL 会尝试加载default_version对应的 SQL 脚本但包内share/extension/postgis--3.5.0.sql是唯一可用脚本。该包将所有.control文件与对应.dll、.sql版本严格绑定避免了“扩展名对、版本号错、SQL 脚本缺失”的三重翻车。2.3makepostgisdb_using_extensions.bat不是批处理而是扩展依赖拓扑的执行引擎该 bat 文件远超“复制文件”范畴它按强依赖顺序执行四步操作预加载 loader 缓存运行loaders.cache初始化shp2pgsql、raster2pgsql等命令行工具的 GDAL 驱动映射注入字体与渲染配置将fonts.confFreeType 字体路径、im-multipress.confImageMagick 压缩策略写入 PostgreSQL 运行环境确保ST_AsPNG()渲染不报font not found注册多扩展控制文件将address_standardizer.control等 6 个.control文件拷贝至share/extension/使CREATE EXTENSION可识别校验 pointcloud_postgis.control 依赖链检查pointcloud.control是否已存在因pointcloud_postgis依赖pointcloud扩展缺一则CREATE EXTENSION pointcloud_postgis必失败。这步序是postgis-bundle区别于单个postgis.zip的核心设计——它把扩展间的 DAG 依赖关系固化为可执行逻辑。3. 安装实操从解压到SELECT ST_Version()返回3.5.0的六步闭环3.1 环境前置检查三道门禁缺一不可提示此步骤耗时 2 分钟但跳过会导致后续 90% 的失败。务必逐条验证。门禁 1PostgreSQL 15.x 64 位服务进程正在运行执行pg_ctl status -D C:\Program Files\PostgreSQL\15\data输出需含pg_ctl: server is running。若显示no server running先启动服务pg_ctl start -D C:\Program Files\PostgreSQL\15\data。门禁 2pg_config路径已加入系统 PATH运行pg_config --version必须返回15.x。若报pg_config is not recognized需手动添加C:\Program Files\PostgreSQL\15\bin至系统环境变量 PATH。门禁 3PostgreSQL 数据目录权限为当前用户完全控制右键C:\Program Files\PostgreSQL\15\share\extension→ 属性 → 安全 → 编辑 → 添加当前用户 → 勾选“完全控制”。Windows UAC 会拦截无权限写入导致.control文件拷贝失败。3.2 解压与目录映射按物理路径硬绑定拒绝“放错位置”将postgis-bundle-pg15-3.5.0x64.zip解压到临时目录如C:\temp\postgis-bundle然后执行精确路径映射# 将 bundle 中的 lib 文件复制到 PostgreSQL 的 lib 目录注意是覆盖非合并 xcopy C:\temp\postgis-bundle\lib\*.dll C:\Program Files\PostgreSQL\15\lib\ /Y /I # 将 share/extension 下的所有 .control 和 .sql 文件复制到 PostgreSQL 的 extension 目录 xcopy C:\temp\postgis-bundle\share\extension\* C:\Program Files\PostgreSQL\15\share\extension\ /Y /I /S # 将 fonts.conf 等配置文件复制到 PostgreSQL 的 etc 目录若不存在则创建 mkdir C:\Program Files\PostgreSQL\15\etc xcopy C:\temp\postgis-bundle\etc\* C:\Program Files\PostgreSQL\15\etc\ /Y /I参数说明/Y跳过覆盖确认/I当目标不存在时自动创建目录/S递归复制子目录。关键点在于lib\下的.dll必须直接落进PostgreSQL\15\lib\不能放在子文件夹中否则module_pathname解析失败。3.3 运行makepostgisdb_using_extensions.bat理解它每行在做什么进入解压目录右键以管理员身份运行该 bat必须管理员因需写入Program Files。其核心逻辑拆解如下echo off :: 步骤1加载 GDAL/OGR 驱动缓存避免 shp2pgsql 报 Unable to load DLL echo Loading GDAL cache... loaders.cache :: 步骤2将 fonts.conf 注入 PostgreSQL 运行时环境变量 echo Setting font config... set PGFONTDIRC:\Program Files\PostgreSQL\15\etc copy fonts.conf %PGFONTDIR%\fonts.conf /Y :: 步骤3拷贝所有 .control 文件到 extension 目录关键 echo Installing extension control files... xcopy address_standardizer.control C:\Program Files\PostgreSQL\15\share\extension\ /Y xcopy postgis_tiger_geocoder.control C:\Program Files\PostgreSQL\15\share\extension\ /Y :: ...其余 4 个 .control 文件同理 :: 步骤4重启 PostgreSQL 服务强制重新加载 extension 元数据 echo Restarting PostgreSQL service... net stop postgresql-x64-15 timeout /t 3 /nobreak nul net start postgresql-x64-15逻辑说明该 bat 不仅复制文件还通过net stop/start强制刷新 PostgreSQL 的 extension 缓存。若仅复制文件而不重启CREATE EXTENSION仍会报extension postgis does not exist因为 PostgreSQL 启动时已将share/extension/目录快照进内存。3.4 在数据库中启用扩展按依赖顺序创建一步都不能乱连接psql如psql -U postgres -d mygisdb严格按以下顺序执行-- 1. 先建基础 postgis提供几何类型和函数 CREATE EXTENSION postgis VERSION 3.5.0; -- 2. 再建 postgis_topology拓扑支持依赖 postgis CREATE EXTENSION postgis_topology VERSION 3.5.0; -- 3. 建 tiger_geocoder地址标准化依赖 postgis CREATE EXTENSION postgis_tiger_geocoder VERSION 3.5.0; -- 4. 建 pgrouting路径分析独立于 postgis 但需其类型 CREATE EXTENSION pgrouting VERSION 3.5.0; -- 5. 建 pointcloud点云支持需先有 pointcloud.control CREATE EXTENSION pointcloud VERSION 3.5.0; CREATE EXTENSION pointcloud_postgis VERSION 3.5.0;参数说明VERSION 3.5.0必须显式指定因.control文件中default_version为3.5.0且包内仅提供postgis--3.5.0.sql脚本。若省略版本PostgreSQL 会尝试加载postgis--unpackaged.sql不存在导致失败。3.5 验证安装成功用四条 SQL 锁死功能可用性执行以下查询每条都必须返回预期结果-- Q1检查 PostGIS 版本核心验证 SELECT PostGIS_Version(); -- 期望返回3.5.0 USE_GEOS1 USE_PROJ1 USE_STATS1 -- Q2检查 tiger_geocoder 是否可调用地址解析验证 SELECT pprint_addy(normalize_address(123 Main St, Anytown, USA)); -- 期望返回含 street、city、state 的 JSON 结构非 NULL -- Q3检查 pgrouting 最短路径函数网络分析验证 SELECT * FROM pgr_dijkstra( SELECT id, source, target, cost FROM edge_table, 1, 5 ); -- 期望返回至少 1 行 path_seq、node、edge、cost非空集 -- Q4检查 pointcloud 点云类型是否注册三维空间验证 SELECT typname FROM pg_type WHERE typname pcpatch; -- 期望返回一行 pcpatch证明 pointcloud 扩展已加载逻辑说明这四条 SQL 覆盖了空间几何、地理编码、网络分析、三维点云四大能力域。任一条失败说明对应扩展未正确加载或依赖缺失需回溯前序步骤。4. 避坑指南那些让工程师凌晨三点还在查 eventvwr.msc 的真实翻车现场4.1 现象CREATE EXTENSION postgis报错could not open extension control file postgis.control原因.control文件未复制到share/extension/目录或复制后 PostgreSQL 服务未重启。PostgreSQL 启动时扫描share/extension/生成内部扩展列表文件新增后不重启则不可见。解决确认C:\Program Files\PostgreSQL\15\share\extension\postgis.control存在执行net stop postgresql-x64-15 net start postgresql-x64-15再试CREATE EXTENSION。4.2 现象SELECT ST_AsGeoJSON(geom)返回ERROR: function st_asgeojson(unknown) does not exist原因postgis-3.5.dll未正确加载常见于lib/目录下存在多个版本.dll如postgis-3.4.dll和postgis-3.5.dll并存PostgreSQL 加载了旧版。解决删除C:\Program Files\PostgreSQL\15\lib\下所有postgis-*.dll仅保留postgis-3.5.dll检查postgis.control中module_pathname $libdir/postgis-3.5是否匹配重启服务。4.3 现象CREATE EXTENSION postgis_tiger_geocoder失败日志显示relation tiger.addr does not exist原因tiger_geocoder 扩展依赖tiger模式下的地址表但postgis-bundle仅提供扩展代码不包含美国 Census Bureau 的原始 tiger 数据。该错误表示 geocoder 已加载但缺少底图数据。解决下载tiger_data_2023.sql官方提供用psql -d mygisdb -f tiger_data_2023.sql导入或使用shp2pgsql加载本地 shapefile注意此非安装包缺陷是 geocoder 的固有设计。4.4 现象shp2pgsql命令行工具报ERROR: Unable to load DLL或GDALOpen failed原因loaders.cache未执行或GDAL_DATA环境变量未指向etc/gdal目录。postgis-bundle中的loaders.cache会生成gdal-data缓存但需GDAL_DATA指向正确路径。解决运行set GDAL_DATAC:\Program Files\PostgreSQL\15\etc\gdal临时或永久添加系统环境变量GDAL_DATA值为C:\Program Files\PostgreSQL\15\etc\gdal再运行shp2pgsql。4.5 现象SELECT ST_AsPNG(ST_GeomFromText(POINT(0 0)))返回ERROR: font not found原因fonts.conf未正确写入etc/目录或PGFONTDIR环境变量未设置。PostGIS 渲染 PNG 依赖 FreeType 字体fonts.conf定义字体路径。解决确认C:\Program Files\PostgreSQL\15\etc\fonts.conf存在执行set PGFONTDIRC:\Program Files\PostgreSQL\15\etc重启 PostgreSQL 服务因PGFONTDIR在服务启动时读取。5. 进阶技巧用pg_restore快速迁移含 PostGIS 的生产库绕过扩展重装地狱5.1 为什么pg_dump默认不导出扩展——理解--no-owner与--no-privileges的真实作用当你用pg_dump mygisdb backup.sql导出数据库生成的 SQL 文件不包含CREATE EXTENSION语句。PostgreSQL 认为扩展是“数据库级基础设施”而非“数据内容”因此默认跳过。若直接psql -d newdb backup.sql新库中虽有空间数据表但ST_Distance等函数仍不可用。正确做法是分离导出# 步骤1导出数据不含扩展定义 pg_dump --no-owner --no-privileges --no-acl --clean --if-exists mygisdb data_only.sql # 步骤2单独导出扩展创建语句关键 pg_dump --sectionpre-data --no-owner --no-privileges mygisdb | grep CREATE EXTENSION extensions.sql参数说明--sectionpre-data仅导出数据库初始化部分含CREATE EXTENSIONgrep提取所有扩展创建行得到纯净的extensions.sql。5.2pg_restore的二进制优势比文本 dump 快 3 倍且自动处理 OID 依赖对于 10GB 的空间数据库文本pg_dump生成的 SQL 文件可能达 20GBpsql导入时易因内存不足中断。pg_restore使用自定义二进制格式压缩率高且并行导入# 创建空库必须先创建因 pg_restore 不建库 createdb -T template0 newgisdb # 连接到新库先执行 extensions.sql启用扩展 psql -d newgisdb -f extensions.sql # 用 pg_restore 导入数据-j 4 启用 4 线程 pg_restore -j 4 -d newgisdb -F c mygisdb.backup逻辑说明-F c指定自定义格式compressed binary-j 4并行化表恢复。pg_restore会自动解析mygisdb.backup中的空间数据 OID并映射到新库的geometry类型无需手动ALTER TABLE。5.3 验证迁移完整性用st_equals检查几何精度而非count(*)迁移后不要只查SELECT count(*) FROM roads要验证空间数据是否失真-- 检查原库与新库中同一道路的几何是否完全相等含坐标精度 SELECT (SELECT ST_AsText(geom) FROM olddb.roads WHERE id 123) AS old_geom, (SELECT ST_AsText(geom) FROM newgisdb.roads WHERE id 123) AS new_geom, ST_Equals( (SELECT geom FROM olddb.roads WHERE id 123), (SELECT geom FROM newgisdb.roads WHERE id 123) ) AS is_equal;参数说明ST_Equals比较两个几何对象的拓扑等价性忽略坐标顺序、重复点返回t表示完全一致。若返回f说明pg_restore过程中发生了 WKB 解析错误需检查postgis-bundle版本是否与源库一致如源库为 pg143.4则不能用 pg153.5 包恢复。从那以后我每次迁移含 PostGIS 的库都强制走一遍pg_dump --sectionpre-data提取 extensions pg_restore -F c二进制恢复的组合流程宁可多花 5 分钟写脚本也不愿在凌晨三点对着ST_Distance returns null的日志抓狂。希望帮到你。本文还有配套的精品资源点击获取