执行pg_restore时遇“[archiver] unsupported version (1.12)”错误求解决

错误原因 #

PostgreSQL的pg_dump备份文件格式是高版本向下不兼容的：你用9.5生成的备份格式版本为1.12，而8.4仅支持更早的格式版本，直接恢复会触发unsupported version错误。

解决步骤 #

1. 用9.5的pg_dump生成纯文本SQL备份 #

必须在装有PostgreSQL 9.5的环境中执行以下命令，生成低版本兼容的纯文本脚本：

pg_dump -U 用户名 -d 目标数据库名 --format=plain --no-owner --no-privileges --encoding=UTF8 > backup_legacy.sql

• --format=plain：生成纯文本SQL，这是跨版本兼容的核心，避免二进制备份的版本锁；
• --no-owner/--no-privileges：跳过所有者和权限语句，避免8.4不存在对应用户/角色的报错；
• --encoding：指定编码与目标8.4数据库一致，防止乱码。

2. 修复SQL脚本中的不兼容内容 #

9.5的部分语法、类型在8.4中不支持，需要手动修改脚本：

• 移除IF NOT EXISTS在CREATE TABLE/CREATE INDEX中的使用，替换为“先判断对象是否存在再创建”的逻辑；
• 将9.5的json/jsonb类型改为text（8.4无原生JSON支持）；
• 删除9.5特有的扩展（如pg_stat_statements）、函数调用或语法（如LATERAL连接）；
• 检查存储过程/自定义函数，替换8.4不支持的PL/pgSQL语法。

3. 在8.4环境中执行恢复 #

将修改后的脚本传到8.4服务器，执行以下命令：

psql -U 用户名 -d 恢复目标库名 -f backup_legacy.sql

如果执行中报错，根据提示逐行修正脚本，直到恢复完成。

注意事项 #

• 纯文本备份体积较大，恢复耗时较长，建议先在测试环境验证流程；
• 若数据库包含大量数据，可分表备份恢复，降低单脚本复杂度；
• 恢复后需验证数据完整性和业务功能是否正常。

内容的提问来源于stack exchange，提问作者isp not