将Heroku PostgreSQL数据库克隆到本地以进行「实时」测试

我之前也碰到过类似的Heroku Postgres克隆卡壳的问题，结合自己踩过的坑给你几个实用的排查和调整方向：

• 先确认pg_dump导出是否有效
  先检查生成的output.sql文件大小，如果文件是空的或者只有几KB，说明导出过程大概率出问题了。你可以简化pg_dump命令，直接用Heroku给的完整DATABASE_URL来导出，避免手动拆分参数出错：

  pg_dump postgres://<username>:<password>@<host_name>:<port>/<dbname> > output.sql
  

  这个命令会直接用完整连接串，不需要单独输入密码，减少交互环节的错误概率。

• 调整psql导入命令的正确姿势
  如果是导入到本地Postgres数据库：

  1. 先创建一个空的本地数据库（如果还没创建）：

     createdb <你的本地数据库名>
     

  2. 再执行导入命令：

     psql -d <你的本地数据库名> -f output.sql
     

  如果是导入到另一个Heroku应用的数据库，更推荐用Heroku官方的推送命令，比手动psql更稳定：

  heroku pg:push output.sql <目标数据库别名（比如DATABASE）> --app <你的目标应用名>
  

• 排查基础连接和权限问题

  • 确保本地Postgres服务处于运行状态：Mac可以用brew services start postgresql，Windows去服务列表里确认PostgreSQL服务已启动。
  • 如果导入到远程数据库，确认目标数据库的安全策略允许你的IP访问（Heroku Postgres默认开放，但自建服务器可能需要配置防火墙）。
  • 导入时如果遇到权限报错，比如无法创建表/序列，要确认你使用的数据库用户拥有足够权限（比如本地可以用超级用户postgres执行导入）。

• 通过详细日志定位具体错误
  不管是导出还是导入，加上-v参数可以输出详细日志，帮你精准定位问题：

  # 带日志的导出
  pg_dump -v postgres://<username>:<password>@<host_name>:<port>/<dbname> > output.sql
  # 带日志的导入
  psql -v -d <目标数据库名> -f output.sql
  

  日志里会明确告诉你是连接超时、语法错误还是权限不足，跟着提示解决就行。

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