Rails 7应用从Heroku迁移至Railway后图片及环境异常求助

1. 解决ImageMagick依赖与Ruby部署耗时/PATH警告 #

• 切换到Heroku buildpack后，别用环境变量声明系统依赖，直接在项目根目录创建Aptfile，写入：

  imagemagick
  libimagemagick-dev
  

  这样buildpack会自动安装这些依赖，避免ImageMagick缺失的报错。
• 确保项目根目录的.ruby-version文件里明确写3.2.1，Railway会读取这个文件安装对应版本Ruby，解决每次部署重新安装的耗时问题，同时消除PATH警告。

2. 修复图片存储到S3而非本地的问题 #

• 检查config/storage.yml的生产环境配置，确保指向S3：

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

• 确认config/environments/production.rb里设置了正确的存储服务：

  config.active_storage.service = :production
  

• 核对Railway的环境变量，AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION、AWS_BUCKET这些参数要和Heroku上的完全一致。

3. 旧图片引发崩溃的问题 #

• Heroku上的Active Storage可能给旧图片生成了变体，迁移后这些变体的元数据在数据库里，但处理时因环境差异失败。
• 处理方案：
  • 重新生成旧图片变体：在Railway控制台执行（或写Rake任务）：

    ActiveStorage::Blob.all.each do |blob|
      next unless blob.image?
      # 替换成你实际使用的变体参数
      blob.variant(resize: '300x300').processed
    end
    

  • 检查视图代码，确保用正确的方法生成S3图片URL，比如：

    <%= image_tag url_for(user.avatar.variant(resize: "300x300")) %>
    

  • 确认数据库中active_storage_blobs表的service_name字段是production，如果之前是其他值，执行SQL更新：

    UPDATE active_storage_blobs SET service_name = 'production' WHERE service_name = 'old_service_name';
    

4. 验证部署状态 #

• 部署完成后，进入Railway控制台执行以下命令确认：

  convert --version # 检查ImageMagick是否安装成功
  ruby -v # 确认Ruby版本为3.2.1
  

• 测试新图片上传，查看S3控制台是否有文件，页面能否正常显示；再测试旧图片，确认不再崩溃。

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