使用pg_restore恢复TimescaleDB（PostgreSQL15）无报错但未恢复数据

问题场景 #

• 环境：Windows 10，PostgreSQL 15 搭配 TimescaleDB
• 操作：预加载TimescaleDB后，在psql交互终端执行恢复命令：

  \! pg_restore -Fc -U postgres -d newdb "C:\example\file\path\bin\dumpfile.sql"
  

  （指定-U postgres是为了避免系统请求不存在的本地用户密码）
• 现象：
  1. 出现警告：pg_restore: warning: invalid creation date in header
  2. 输入密码后无任何输出，执行\d或通过pgAdmin确认目标数据库无任何表/数据
  3. 该备份文件曾在Windows 11环境成功恢复，其他Windows 10协作伙伴可正常使用

排查与解决步骤 #

1. 校验备份文件完整性与格式匹配 #

• 先检查备份文件是否可正常读取，执行以下命令查看备份内容列表：

  pg_restore -l "C:\example\file\path\bin\dumpfile.sql"
  

  若能正常列出表、函数、TimescaleDB hypertables等对象，说明文件未损坏；若报错，需重新获取备份。
• 注意：命令中使用了-Fc（PostgreSQL自定义格式），但备份文件后缀为.sql，确认备份实际格式：
  • 若备份是用pg_dump -Fc导出的自定义格式文件，建议将后缀改为.dump避免混淆；
  • 若备份是纯SQL文本格式，需去掉-Fc参数，改用psql执行恢复：

    psql -U postgres -d newdb -f "C:\example\file\path\bin\dumpfile.sql"
    

2. 调整命令执行环境 #

• 避免在psql交互终端内用\!执行pg_restore，直接在Windows CMD或PowerShell中执行命令，减少终端环境干扰：

  pg_restore -Fc -U postgres -d newdb "C:\example\file\path\bin\dumpfile.sql"
  

• 添加-v（verbose）参数开启详细日志，查看恢复过程中的具体执行细节与潜在错误：

  pg_restore -v -Fc -U postgres -d newdb "C:\example\file\path\bin\dumpfile.sql"
  

3. 修复日期格式解析问题 #

• invalid creation date in header警告通常是跨系统日期格式解析差异导致，可通过以下方式解决：
  • 临时设置环境变量强制使用标准日期格式：
    在CMD中执行：

    set PGDATESTYLE=ISO, MDY
    pg_restore -v -Fc -U postgres -d newdb "C:\example\file\path\bin\dumpfile.sql"
    

  • 或调整系统区域日期格式为与Windows 11成功恢复时一致的格式（如yyyy-MM-dd）：
    打开「控制面板」→「区域」→「格式」进行设置。

4. 确认TimescaleDB扩展状态 #

• 恢复前确保目标数据库newdb已启用TimescaleDB扩展，否则TimescaleDB专属对象（如hypertables）无法正常恢复：
  在psql中执行：

  CREATE EXTENSION IF NOT EXISTS timescaledb;
  

5. 检查权限与连接配置 #

• 确认postgres用户对目标数据库newdb拥有足够权限：

  GRANT ALL PRIVILEGES ON DATABASE newdb TO postgres;
  

• 检查pg_hba.conf配置，确保允许postgres用户本地连接（可临时设置为trust测试，测试完成后改回原认证方式）。

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