CentOS 上 PostgreSQL 的兼容性与避坑要点
总体兼容性与系统版本建议
- 在 CentOS 7/8 上，PostgreSQL 与系统整体兼容性良好，可通过系统仓库或官方 RPM 源稳定安装与运行。生产环境常见选择为 PostgreSQL 14.x/15.x 等稳定版本。需要注意的是，CentOS 7 与 CentOS 8 已停止维护，建议迁移至 Rocky Linux、AlmaLinux、Ubuntu LTS、SUSE、Amazon Linux、CentOS Stream 或 RHEL 等仍在支持期的发行版，以获得安全更新与驱动/库层面的兼容保障。
常见兼容性问题与对策
- 老系统与新驱动/库的错配（libpq 版本过低）
- 现象：Python 应用使用 psycopg2 时报错，如 “Psycopg requires PostgreSQL client library (libpq) >= 9.1”，或运行期出现 “undefined symbol: PQescapeIdentifier” 等符号未定义错误。
- 原因：系统自带的 libpq 过旧，或应用加载了错误路径的库。
- 处理：升级 PostgreSQL 客户端/服务器 至 9.1+；在应用环境中正确设置 LD_LIBRARY_PATH 指向新库目录，或调整系统库链接，使 httpd/WSGI/应用能加载到新版本的 libpq.so。必要时用 ldd 检查 _psycopg.so 的依赖链路。
- 扩展与依赖矩阵不匹配（PostGIS 典型）
- 现象：在 CentOS 8 上组合 PostgreSQL 9.6 + PostGIS 2.3 时，常见 “undefined symbol: geod_init” 或 “required extension postgis is not installed” 等错误，构建与加载依赖复杂且易失败。
- 原因：PostGIS/GEOS/PROJ/GDAL 等依赖版本与 PG 版本、操作系统库版本之间存在严格矩阵约束。
- 处理：优先升级 PostgreSQL 至 10+（如 12） 再安装对应版本的 PostGIS；或改用已验证的发行版/容器镜像，避免跨大版本的扩展组合。
- 系统停服带来的间接不兼容
- 现象：安全补丁、glibc/openssl 更新滞后，间接导致客户端/驱动/扩展构建或运行异常。
- 处理：迁移至受支持的 Linux 发行版 与对应官方仓库，保持系统库与驱动链路的同步更新。
版本选择与升级策略
- 版本选择
- 新部署优先选择受支持系统上的 PostgreSQL 14.x/15.x；若受限于应用，至少选择 12.x 以获得更好的扩展与生态支持。
- 升级路径
- 小版本升级（如 12.4 → 12.7）：不改变存储格式，通常可直接替换二进制并重启服务完成。
- 大版本升级（如 12 → 13/14/15）：需额外步骤，常用三种方式：
- 逻辑备份/还原（pg_dump/pg_restore）：适合中小型数据库（< 100 GB），操作简单，但停机时间与数据量成正比。
- pg_upgrade：适合大中型数据库（> 100 GB），支持本机就地升级，配合 –check 预检，使用 –link 可显著缩短停机（几分钟级）。
- 逻辑复制：适合大中型且需跨平台/零停机场景，切换窗口可做到秒级。
- 跨多个主要版本升级时，务必逐版本阅读发行说明的 Migration 部分，评估 SQL/类型/扩展的不兼容变更。
快速自检清单
- 核对系统与内核：cat /etc/redhat-release；uname -r；确保系统处于支持期。
- 核对 PostgreSQL 与服务：psql --version；sudo systemctl status postgresql-；确认数据目录与端口。
- 核对客户端库一致性：ldd $(which psql) 与 ldd /path/to/_psycopg.cpython-*.so，确保加载的 libpq 与服务器版本匹配。
- 核对扩展依赖矩阵：PostGIS/GEOS/PROJ/GDAL 与当前 PostgreSQL 主版本匹配；必要时用 SELECT * FROM pg_available_extensions; 验证可用扩展与版本。
