部署代码至Heroku执行rails db:migrate时出现Relation does not exist错误

嘿，我之前也碰到过类似的Heroku数据库迁移问题，结合你给出的日志片段——在执行AddShopToListing迁移的add_reference步骤时出错，大概率是迁移语法或数据库表依赖的问题，给你几个排查和解决的方向：

• 检查迁移文件的语法规范
  你当前用的add_reference(:listings, :shop, {:references=>:shops, :index=>true})写法虽然不算错，但Rails更推荐标准简洁的写法，而且Heroku上的PostgreSQL有时对非标准参数兼容性不太好。建议把迁移文件里的这行改成：

  add_reference :listings, :shop, foreign_key: true, index: true
  

  默认情况下add_reference会自动关联shops表，其实可以省略references: :shops参数，确保参数格式符合Rails的标准写法。

• 确认迁移执行顺序是否正确
  迁移是按照文件开头的时间戳顺序执行的，如果AddShopToListing迁移的时间戳比创建shops表的迁移更早，那执行时shops表还不存在，肯定会报错。去db/migrate目录下看看所有迁移文件的时间戳，确保创建shops表的迁移先于这个关联迁移执行。

• 手动排查Heroku数据库状态
  先通过命令登录Heroku的PostgreSQL控制台：

  heroku pg:psql
  

  然后执行\dt查看所有已存在的表，确认shops表是否存在；再执行SELECT * FROM schema_migrations;查看已经成功执行的迁移记录，检查创建shops表的迁移是否已经完成。

• 修复后重新部署迁移
  如果是迁移文件的问题，修改后提交代码并推送到Heroku：

  git add db/migrate/your_migration_file.rb
  git commit -m "Fix migration syntax for adding shop reference to listings"
  git push heroku main
  

  然后重新执行迁移：

  heroku run rails db:migrate
  

  如果之前的迁移已经部分执行导致状态异常，可以先回滚最近一次迁移：

  heroku run rails db:rollback
  

  再重新执行迁移。

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