Heroku部署应用无法读取seeds.rb种子数据本地运行正常如何解决

优先排查基础操作遗漏 #

• Heroku部署流程默认不会自动执行seed写入任务，本地能看到数据是因为本地开发时手动跑过rails db:seed，线上环境需要单独执行命令触发数据写入：

  # 先确保数据库迁移已经执行完成
  heroku run rails db:migrate
  # 再执行种子数据导入
  heroku run rails db:seed
  

• 执行完成后直接进线上控制台校验数据是否存在，不要靠页面展示判断，避免缓存、路由问题干扰判断：

  heroku run rails console
  # 控制台内执行对应模型的计数查询，例如查询用户表数据量
  > User.count
  

排查seed执行过程的静默报错 #

如果执行完seed命令数据还是为空，大概率是脚本执行中途因为环境差异报错退出，但没有抛出终止级别的错误：

• 带全量trace日志重新执行seed，定位具体报错点：

  heroku run rails db:seed --trace
  

• 常见触发报错的场景：
  • 线上环境开启了模型校验、回调逻辑，本地development环境关闭了对应校验，导致数据创建校验失败
  • seeds.rb里写了依赖本地文件、本地服务的硬编码路径，线上环境访问不到对应资源
  • 线上数据库账号权限不足，无法写入对应数据表
• 如果脚本里有分支判断逻辑，可以临时在分支节点加puts打印标记，确认代码有没有实际走到数据创建的逻辑块。

排查环境配置差异 #

• 确认Heroku的环境变量配置正确，执行heroku config:get RAILS_ENV，返回值必须是production，如果seeds.rb里写了仅在development环境生效的判断逻辑，环境变量不对就不会执行数据创建
• 检查是否有多数据库配置，确认seed任务连接的是线上生产库，不是误连到其他空的数据库实例
• 不要把种子数据存在项目本地文件、Heroku临时文件系统里，Heroku的文件系统是瞬时的，应用重启后所有本地存储的文件都会被清空，所有持久化数据必须写入Heroku提供的Postgres数据库。

排查数据库状态异常 #

• 执行heroku pg:info查看线上数据库状态，确认数据库没有被重置、存储没有超过免费层配额，超配额后数据库会进入只读状态，无法写入任何数据
• 如果数据库被意外清空，重新执行迁移+seed流程即可恢复数据。

可选：配置部署自动执行seed #

如果不想每次部署手动跑seed，可以在项目根目录的Procfile里配置release阶段任务，每次部署完成后自动执行迁移和seed：

release: rails db:migrate && rails db:seed
web: bin/rails server -p $PORT -e $RAILS_ENV

注意：自动执行seed必须给脚本加幂等判断，避免重复部署时创建重复数据，示例写法：

# seeds.rb 幂等写法 存在则更新，不存在则创建
Admin.find_or_create_by!(email: 'admin@example.com') do |admin|
  admin.password = 'secure_default_pwd'
  admin.name = '系统管理员'
end

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