Debian 上 PostgreSQL 版本兼容测试实操指南
一 目标与总体思路
- 明确目标：验证从当前 Debian 上的 PostgreSQL 旧版本到目标版本在数据与功能层面的可用性，覆盖配置、扩展、SQL、权限、性能与回滚预案。
- 基本原则：
- 小版本升级（如 14.5 → 14.7）仅替换可执行文件并重启，内部存储格式不变，通常无需迁移数据，适合作为低风险的基线验证。
- 大版本升级（如 14.x → 15.x）需通过 pg_upgrade 或逻辑转储迁移数据，必须做完整兼容性与回归测试。
二 测试环境准备
- 资源与隔离：在同一台宿主机或隔离网络中准备测试环境，避免端口与数据目录冲突；使用与生产一致的 Debian 版本与库依赖。
- 安装目标版本：
- 使用 APT 安装目标版本（可添加 PostgreSQL 官方 APT 仓库），如：sudo apt install postgresql-15。
- 数据获取与脱敏：
- 全量备份：sudo -u postgres pg_dumpall > backup.sql；如涉敏，先做脱敏或子集抽取。
- 目录与实例规划（示例）：
- 旧集群：/var/lib/postgresql/14/main
- 新集群：/var/lib/postgresql/15/main
- 配置基线：
- 复制并对比关键配置：postgresql.conf、pg_hba.conf；保留必要的自定义参数，避免跨版本参数变更引发异常。
三 兼容测试矩阵与关键检查
- 配置与参数
- 核对 postgresql.conf 中已变更或被废弃的参数；逐项验证对连接、内存、WAL、并行等的实际影响。
- 扩展与依赖
- 列出已安装扩展：SELECT * FROM pg_available_extensions WHERE installed_version IS NOT NULL;
- 确认目标版本支持情况与版本匹配（如 PostGIS、pgcrypto、pg_stat_statements 等），必要时先行升级扩展版本。
- SQL 与对象
- 使用 plpgsql_check 对 PL/pgSQL 函数/触发器做静态检查：CREATE EXTENSION plpgsql_check; SELECT * FROM plpgsql_check_function_all();
- 回归核心业务 SQL、视图、触发器与存储过程，关注隐式类型转换、废弃语法、返回类型变更等。
- 权限与认证
- 校验 pg_hba.conf 规则、角色/模式权限、默认权限与 SECURITY DEFINER 对象在新版本的行为一致性。
- 性能与回归
- 在相同数据量与工作负载下，对比关键查询与批处理作业的响应时间与资源占用，确认无退化。
- 可用性与回滚
- 验证新实例启动、主备切换（如有）、监控与日志采集链路；保留旧实例与备份，确保可快速回滚。
四 大版本升级的两种迁移路径与验证
- 路径 A：使用 pg_upgrade（速度快，就地升级）
- 兼容性检查（不写盘）：
- sudo -u postgres /usr/lib/postgresql/15/bin/pg_upgrade
-b /usr/lib/postgresql/14/bin -B /usr/lib/postgresql/15/bin
-d /var/lib/postgresql/14/main -D /var/lib/postgresql/15/main --check
- 执行升级（示例）：
- sudo -u postgres /usr/lib/postgresql/15/bin/pg_upgrade
-b /usr/lib/postgresql/14/bin -B /usr/lib/postgresql/15/bin
-d /var/lib/postgresql/14/main -D /var/lib/postgresql/15/main
-o ‘-c config_file=/etc/postgresql/14/main/postgresql.conf’
-O ‘-c config_file=/etc/postgresql/15/main/postgresql.conf’
- 升级后处理：
- 重建统计信息：sudo -u postgres /usr/lib/postgresql/15/bin/vacuumdb --all --analyze-in-stages
- 逐项执行“兼容测试矩阵”，确认对象可用与性能达标。
- 路径 B：逻辑转储（安全、跨版本兼容性好）
- 导出：sudo -u postgres pg_dumpall -f /path/to/backup.sql
- 初始化新集群：sudo -u postgres /usr/lib/postgresql/15/bin/initdb -D /var/lib/postgresql/15/main
- 导入：sudo -u postgres psql -f /path/to/backup.sql postgres
- 启动新实例后执行“兼容测试矩阵”。
- 判定与回滚
- 任一关键检查失败，立即停掉新实例，保留旧实例与备份，定位问题后再行测试；所有检查通过后再安排切换窗口。
五 小版本升级的验证要点
- 操作方式：停止旧版本服务，更新同主版本包（如 postgresql-14），启动新版本；数据目录与存储格式保持不变。
- 验证要点：
- 版本确认：sudo -u postgres psql -c “SELECT version();”
- 核心业务回归、性能对比与错误日志检查。
- 查阅该小版本的 Release Notes，按官方提示执行必要后续操作（例如历史上某些小版本修复 B-tree 索引问题后需重建索引）。