Ruby 2.7.6升级至3.1.2+Rails7后Heroku启动崩溃求助

可能原因 #

• storage.yml文件未提交至Git仓库：本地存在该配置文件，但未添加、提交并推送到Heroku，导致服务器端缺少必要的Active Storage配置文件
• storage.yml配置与Heroku环境不兼容：比如配置了仅适用于本地的存储服务，或引用了未在Heroku中设置的环境变量
• Rails 7 Active Storage配置规则变更：升级后未适配Rails 7对Active Storage的默认配置要求，比如服务名称映射规则调整
• Heroku环境变量未正确配置：启动时无法加载storage.yml中依赖的敏感信息（如云存储密钥）

解决步骤 #

1. 确认storage.yml已纳入Git追踪 #

• 运行git status查看config/storage.yml是否在已追踪文件列表中
• 若未追踪，执行以下命令提交：

  git add config/storage.yml
  git commit -m "Track config/storage.yml for Heroku deployment"
  git push heroku main
  

• 注意：禁止在storage.yml中硬编码敏感信息，全部改用环境变量引用

2. 调整storage.yml适配Heroku环境 #

如果使用AWS S3等云存储，参考以下配置模板：

production:
  service: S3
  access_key_id: <%= ENV['AWS_ACCESS_KEY_ID'] %>
  secret_access_key: <%= ENV['AWS_SECRET_ACCESS_KEY'] %>
  bucket: <%= ENV['S3_BUCKET_NAME'] %>
  region: <%= ENV['AWS_REGION'] %>

若仅用于临时测试，可使用本地磁盘存储（注意：Heroku临时存储重启后数据会丢失）：

production:
  service: Disk
  root: <%= Rails.root.join("storage") %>

3. 检查并补充Heroku环境变量 #

• 运行heroku config查看已设置的环境变量，确认storage.yml中引用的变量全部存在
• 缺失的变量通过以下命令添加：

  heroku config:set AWS_ACCESS_KEY_ID=你的密钥ID AWS_SECRET_ACCESS_KEY=你的密钥 S3_BUCKET_NAME=你的存储桶名称 AWS_REGION=你的区域
  

4. 验证Rails 7 Active Storage初始化配置 #

• 检查config/application.rb是否包含require "active_storage/engine"，Rails 7默认已集成，但升级时可能遗漏
• 检查config/environments/production.rb中的Active Storage服务配置：

  config.active_storage.service = :production
  

  确保:production与storage.yml中定义的服务名称一致

5. 重新部署并排查日志 #

• 重新部署应用：git push heroku main
• 实时查看启动日志：heroku logs --tail，确认配置加载情况，若仍有错误可根据新日志进一步定位问题

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