pg_restore不支持备份版本怎么办
恢复 PostgreSQL 备份时,一开始就提示 unsupported version ... in file header,先核对正在运行的 pg_restore。这个错误发生在读取归档头时,常见情况是恢复工具比导出工具旧,尚不能读取它生成的归档格式。此时给数据库增加权限或反复重建目标库,通常解决不了归档解析问题。
下面讨论 PostgreSQL 逻辑备份,命令示例使用 Linux Bash。保留原备份与导出日志,不修改文件头,也不通过改后缀把它变成另一种备份。
确认真正执行的是哪套工具
服务器装了新版本,终端、定时任务和数据库管理软件仍可能调用旧目录中的客户端。先在发生错误的同一环境运行:
command -v pg_restore
pg_restore --version
pg_restore --list /backup/app.dump
将路径替换为自己的归档。这里的 --list 只读取备份目录,不恢复到数据库,也不需要加 -d。如果这一步就报相同错误,先处理文件和客户端,不进行正式恢复。
数据库管理软件的恢复任务可能使用单独配置的客户端目录,不一定沿用系统 PATH。检查任务日志中的实际可执行文件路径;终端显示的新版本,不能代替界面工具实际调用版本的证据。
四项版本分别记录,不能只问数据库几
| 需要记录的版本 | 从哪里核对 | 它决定什么 |
|---|---|---|
| 源 PostgreSQL 服务端 | 原导出记录;源端仍可访问时核对服务器版本 | 原库使用的功能和对象环境。 |
| 创建该备份的 pg_dump | 当次备份日志、工具路径及版本记录 | 归档格式和导出内容的生成方式。 |
| 当前实际 pg_restore | 出错任务调用的程序路径及 --version | 能否理解当前归档格式及相关压缩方式。 |
| 目标 PostgreSQL 服务端 | 连接预定隔离目标后查询版本 | 是否能执行恢复产生的 SQL,并具备所需扩展。 |
文件头里的 1.x 是归档格式编号,不是 PostgreSQL 主版本号,不能按其中的数字直接决定装哪一代数据库。也不能把今天运行 pg_dump --version 的结果,当成几个月前生成备份时的版本。
优先使用与导出工具同主版本、来自官方发行包或受信任系统软件源的配套 pg_restore。安装或选择合适的客户端工具,不等于必须升级、重启数据库服务。用新工具的完整路径先查看版本,再执行同一份备份的 --list,避免 PATH 继续选到旧程序。
能读出目录后,核对其中的 Dumped from database version 和 Dumped by pg_dump version,补齐当次记录。若版本仍不明确,先找回导出任务日志,不猜一个版本直接开始覆盖恢复。
换对客户端仍读不开,就检查文件
归档头损坏也可能读出异常版本。把接收端文件的大小、SHA256 与已确认导出完成的原始文件核对;导出中断、传输未完成、只复制了一部分目录,都要回到源文件检查。操作方法见备份下载后如何核对SHA256。
- 自定义、tar、目录格式:由 pg_restore 读取。目录格式要保留整套目录和数据文件,不能只拿一个 toc 文件来恢复。
- 纯文本 SQL:由 psql 执行;它不是 pg_restore 归档。按导出记录确认格式,文件名叫 .dump 或 .sql 都不能单独作为判断依据。
- 外层又压缩或加密:先按原备份流程在受控位置解包或解密,保留原件;不能直接把外层文件当内部归档。
校验一致只说明复制前后相同,不保证原备份有效。不要用十六进制编辑器改头部版本号,也不要反复转换覆盖唯一原件。出现压缩支持、意外文件结束等新错误时,按新错误继续检查,不再统一归为“数据库版本低”。
目录能读出来,才开始兼容性演练
客户端能解析归档,不代表目标服务端能执行全部 SQL。pg_dump 不能导出比自身主版本更新的服务端;其输出恢复到更旧主版本的服务端也没有兼容保证,即使源库原本就是那个旧版本。扩展、排序规则及对象定义仍需单独核对。
使用隔离目标的现有连接确认身份和版本:
SELECT current_database(), inet_server_addr(),
inet_server_port(), version();
目标确认无误后,再按PostgreSQL备份与恢复验证教程在全新空测试库演练。不要加 --clean 覆盖已有对象;--create 会按归档里的库名恢复,不能只看命令行的 -d 就认为目标被限制住。
验收要覆盖完整恢复退出码、错误日志、关键对象与应用读取结果。--list 成功只证明目录可以解析,不能证明每块数据都完整。记录最终使用的客户端路径和四项版本,下一次恢复就能直接选对工具。