使用pg_restore恢复PostgreSQL数据库时出现异常约束/索引不存在错误

核心原因 #

你执行的pg_restore -c命令中，-c参数会让pg_restore在恢复前先删除目标库中已存在的同名对象；如果你的备份文件是用pg_dump --clean选项生成的，备份文件内部已经包含了删除这些约束、索引的SQL命令。这就导致了重复执行删除操作：

1. pg_restore -c先删除了目标库中的fk_rails_998a00e446、fk_rails_24e1b904b4和index_chains_on_site_id
2. 随后执行备份文件自带的DROP命令时，这些对象已不存在，因此抛出“不存在”的错误

少数情况下也可能是备份文件记录的对象OID与目标库不匹配，但最常见的原因还是重复清理操作。

错误的影响 #

这些错误属于非致命警告，pg_restore会自动忽略并继续执行后续步骤。最终数据库能正常恢复完成，因为备份文件中包含重新创建这些约束和索引的命令，不会破坏数据完整性。

解决方案 #

• 若无需提前清理目标库对象，直接去掉pg_restore命令中的-c参数：

  pg_restore -d db_name -Fc backup_file
  

• 若需要清理目标库，但备份文件已包含--clean生成的清理命令，同样去掉-c参数避免重复删除；或者重新生成不带--clean的备份文件，再用pg_restore -c恢复。

验证方法 #

恢复完成后，可通过以下SQL检查目标库的约束和索引是否正常：

-- 检查chains表的外键约束
SELECT conname FROM pg_constraint WHERE conrelid = 'public.chains'::regclass AND contype = 'f';
-- 检查指定索引
SELECT indexname FROM pg_indexes WHERE tablename = 'chains' AND indexname = 'index_chains_on_site_id';

若能查询到对应的约束和索引，说明恢复成功。

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