PostGIS Tiger Geocoder 2025.2 已发布。这是 postgis_tiger_geocoder 从 PostGIS 核心项目拆分后推出的第二个版本，也标志着这个扩展正在形成独立的发布节奏和维护边界。对于依赖美国 Census TIGER 数据进行地址标准化、地理编码和反向地理编码的 PostgreSQL 用户来说，升级时需要重点关注 PostgreSQL 版本要求，以及未来 PostGIS 3.7 的组件变化。
版本边界已经发生变化
2025.2 要求 PostgreSQL 16 或更高版本，同时应当兼容所有当前受支持的 PostGIS 版本。这里有两个容易混淆的版本维度：
postgis_tiger_geocoder的版本依据当前发布时使用的美国 Census TIGER 数据年份命名。- PostGIS 主项目与 Tiger Geocoder 的版本不再完全绑定。
PostGIS 3.6 系列仍然是最后一个包含 postgis_tiger_geocoder 的 PostGIS 系列。从 PostGIS 3.7 开始，主项目将不再打包这个扩展。Tiger Geocoder 已经拥有独立的代码仓库，并在 PostGIS 组织下维护。
这意味着部署脚本、软件包依赖和升级文档都不应再假定“安装 PostGIS 就一定包含 Tiger Geocoder”。生产环境最好把空间数据库能力和美国地址地理编码能力分别记录、分别验证。
先检查运行环境
升级前可以在目标数据库中检查 PostgreSQL、PostGIS 以及扩展是否已经安装：
SELECT version();
SELECT PostGIS_Full_Version();
SELECT name, default_version, installed_version
FROM pg_available_extensions
WHERE name IN ('postgis', 'postgis_tiger_geocoder');
如果 installed_version 为空，说明扩展尚未安装到当前数据库；如果 default_version 不存在，则通常表示当前 PostgreSQL 软件包或扩展目录中没有提供该组件。此时应先确认系统安装了与 PostgreSQL 16 相匹配的 Tiger Geocoder 扩展文件，而不是只执行 SQL 安装命令。
安装或升级数据库扩展时，可以使用下面的命令：
# 连接到目标数据库，创建扩展
psql --version
psql -X -v ON_ERROR_STOP=1 -d gis -c \
"CREATE EXTENSION IF NOT EXISTS postgis;"
psql -X -v ON_ERROR_STOP=1 -d gis -c \
"CREATE EXTENSION IF NOT EXISTS postgis_tiger_geocoder;"
# 已安装旧版本时，查看可用版本并执行升级
psql -X -d gis -c \
"SELECT name, installed_version, default_version \
FROM pg_available_extensions \
WHERE name = 'postgis_tiger_geocoder';"
psql -X -v ON_ERROR_STOP=1 -d gis -c \
"ALTER EXTENSION postgis_tiger_geocoder UPDATE;"
这些命令假设数据库名为 gis，并且当前用户具有创建扩展所需的权限。生产环境执行 ALTER EXTENSION ... UPDATE 前，应先查看目标版本提供的升级脚本、备份数据库，并在测试库验证已有地理编码结果是否仍符合业务要求。
TIGER 数据年份会影响结果可复现性
Tiger Geocoder 的版本模型与美国 Census TIGER 数据年份关联，因此地址匹配结果不能只记录数据库引擎版本和 PostGIS 版本。对于需要审计或长期复现的系统，还应记录：
postgis_tiger_geocoder的版本；- 使用的 TIGER 数据年份；
- 导入的州、县或其他行政区域范围；
- 地址标准化和地理编码时使用的配置；
- 数据导入时间以及源数据更新批次。
一个最小的应用侧验证流程可以这样写：
-- 示例：确认扩展版本，并检查地址规范化函数是否可调用
SELECT extname, extversion
FROM pg_extension
WHERE extname IN ('postgis', 'postgis_tiger_geocoder');
SELECT pprint_addy(
normalize_address('1600 Pennsylvania Ave NW, Washington, DC 20500')
);
上面的函数调用用于说明验证方式。具体函数签名和返回结果应以目标版本的扩展文档及本地安装结果为准；在正式系统中，不要只依赖单次函数调用判断升级成功，还应使用一组固定地址样本进行回归测试，比较标准化地址、匹配状态和坐标变化。
面向 PostGIS 3.7 的迁移建议
如果当前系统使用 PostGIS 3.6 或更早版本，并且部署流程默认从 PostGIS 主软件包获得 Tiger Geocoder，那么迁移到 PostGIS 3.7 前需要调整安装方式。建议把下面几项加入升级清单：
- 确认操作系统或容器镜像是否提供独立的
postgis_tiger_geocoder软件包。 - 确认该软件包面向 PostgreSQL 16 或更高版本编译，并与目标 PostGIS 版本兼容。
- 在测试数据库中执行扩展升级和地址样本回归测试。
- 将扩展版本、TIGER 数据年份和导入范围写入部署元数据。
- 在备份恢复演练中验证扩展文件和数据库扩展定义都能正常恢复。
对于新项目，较稳妥的做法是从一开始就把 postgis 与 postgis_tiger_geocoder 视为两个独立依赖。这样可以减少未来主项目移除该组件时的意外，并让美国地址地理编码数据的更新周期更清晰。
结语：升级重点不只是执行一条 SQL
2025.2 的重要变化不在于新增一个简单的扩展版本号，而在于 Tiger Geocoder 的项目边界、发布方式和兼容性要求已经更加明确。使用者应重点确认 PostgreSQL 16+ 环境、独立扩展的安装来源，以及 TIGER 数据年份对结果复现的影响。
可以用下面的清单收尾：
- [ ] PostgreSQL 版本至少为 16；
- [ ] 目标 PostGIS 版本处于受支持范围；
- [ ]
postgis_tiger_geocoder作为独立依赖安装并记录版本； - [ ] 升级前完成固定地址样本回归测试；
- [ ] 为 PostGIS 3.7 不再内置 Tiger Geocoder 做好部署调整。
对生产系统而言，扩展安装、数据导入和地理编码结果都应纳入同一套版本管理，而不是把 Tiger Geocoder 当作 PostGIS 安装后的隐含组件。