PostgreSQL 大版本升级前，确保回滚安全的核心是在升级前完成全量逻辑备份或物理备份，并确认备份文件可在新版本或同版本环境中恢复。适用于所有生产集群，风险边界在于 PostgreSQL 大版本间数据文件不兼容，升级后无法直接降级，必须通过还原备份回滚。

命令速用版

以下命令用于在升级前创建逻辑备份和物理备份，执行前需确保磁盘空间充足。

# 逻辑备份（推荐，兼容性好）
pg_dumpall -U postgres -f /backup/pre_upgrade_dump.sql

# 物理备份（速度快，需版本一致还原）
pg_basebackup -U postgres -D /backup/base_backup -Ft -z -P

为什么会这样

PostgreSQL 大版本升级会修改内部存储格式，导致数据目录无法被旧版本服务器读取。官方文档明确指出大版本间数据文件不兼容，因此升级操作本质是迁移而非原地修改，一旦升级完成，旧版本二进制文件无法启动新格式的数据目录，回滚只能依赖升级前的备份还原。

分步处理

按顺序执行以下步骤，确保每一步都有检查点。

1. 停止应用写入：切断业务连接，防止备份期间产生不一致数据。
2. 执行备份：运行上述 pg_dumpall 或 pg_basebackup 命令，记录开始和结束时间。
3. 验证备份文件：检查备份文件大小是否非零，逻辑备份可尝试用 pg_restore `--list` 查看内容。
4. 保留旧环境：不要立即删除旧版本数据目录和二进制文件，至少保留到升级验证完成。
5. 执行升级：使用 pg_upgrade 或初始化新集群后还原数据。

怎么验证是否生效

备份生效的唯一标准是成功还原。建议在测试环境使用备份文件执行还原操作，并比对关键表行数。

# 检查逻辑备份内容
pg_restore `--list` /backup/pre_upgrade_dump.sql

# 还原后检查行数
psql -c "SELECT count(*) FROM critical_table;"

查看 PostgreSQL 日志文件（通常在 log_directory 配置路径），确认还原过程无 ERROR 级别报错。

常见坑

• pg_upgrade 链接模式：使用 `--link` 参数会硬链接旧数据文件，升级后旧集群无法启动，若需回滚必须提前独立备份。
• 扩展兼容性：部分第三方扩展在大版本间可能不兼容，升级前需确认扩展是否有新版本支持。
• 权限丢失：逻辑备份通常包含权限信息，但物理备份还原需确保 pg_hba.conf 和角色配置一致。

常见问题

升级后能直接降级回旧版本吗？

不能。PostgreSQL 大版本间数据目录不兼容，降级必须使用升级前的备份重新初始化集群并还原数据。

逻辑备份和物理备份选哪个？

为确保回滚安全，优先选逻辑备份（pg_dumpall），因为它不依赖特定版本的数据文件格式，还原灵活性更高。

备份需要停机多久？

公开资料中没有看到可靠的量化数据，具体时长取决于数据量大小和磁盘 I/O 性能，需在测试环境预先评估。

参考来源

• PostgreSQL Official Documentation, "Upgrading Using pg_dumpall", https://www.postgresql.org/docs/current/upgrade.html
• PostgreSQL Official Documentation, "Physical Backup", https://www.postgresql.org/docs/current/continuous-archiving.html