将Rails ActiveStorage附件迁移至S3后，旧文件无法加载求助

出现NoSuchKey错误的核心原因是仅更新数据库中Blob的service_name远远不够，以下是你遗漏的关键步骤：

1. 本地文件未同步至S3存储桶 #

你修改的只是数据库记录的服务标识，但旧图片的实际文件还留在本地./storage目录里，S3存储桶中根本没有这些文件，自然会返回「找不到对象」的错误。

解决方法：批量迁移本地文件到S3 #

编写Rake任务或脚本，遍历所有旧Blob，将本地文件上传到S3对应路径，保持Blob的key作为S3的对象键（这是ActiveStorage定位文件的核心标识）。示例Rake任务如下：

# lib/tasks/active_storage_migrate.rake
namespace :active_storage do
  desc "迁移本地ActiveStorage文件至DigitalOcean S3"
  task migrate_to_s3: :environment do
    # 本地存储服务实例
    local_service = ActiveStorage::Blob.service
    # 目标S3服务实例
    s3_service = ActiveStorage::Service.configure(
      :digitalocean_s3, 
      Rails.configuration.active_storage.service_configurations[:digitalocean_s3]
    )

    # 遍历所有原本地服务的Blob
    ActiveStorage::Blob.where(service_name: 'local').find_each do |blob|
      # 跳过已存在的文件
      next if s3_service.exist?(blob.key)

      # 下载本地文件并上传至S3
      file_content = local_service.download(blob.key)
      s3_service.upload(blob.key, file_content, checksum: blob.checksum)
      puts "已迁移Blob: #{blob.id} - #{blob.filename}"
    end

    # 再次确认更新所有Blob的服务标识（可选，若已执行过可跳过）
    ActiveStorage::Blob.update_all(service_name: 'digitalocean_s3')
  end
end

执行命令：bundle exec rails active_storage:migrate_to_s3

2. 验证Blob的key与S3对象路径匹配 #

ActiveStorage通过Blob的key字段定位文件，上传时必须确保S3上的对象路径和Blob的key完全一致。如果手动上传时修改了路径，会导致URL无法匹配到正确文件。

3. 检查S3服务权限配置 #

• 确认Rails应用使用的S3凭证拥有读取存储桶对象的权限
• 检查存储桶的CORS配置是否允许应用域名访问（若前端直接加载图片）
• 若使用预签名URL，确保服务端生成的签名权限有效

注意事项 #

• 执行迁移前务必备份本地存储文件和数据库
• 先在测试环境验证脚本逻辑，再在生产环境执行
• 迁移完成后可按需删除本地./storage目录的旧文件

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