Rails 6.1如何实现旧Active Storage存储文件的正常下载

Rails 6.1对Active Storage的S3存储适配器做了迭代，新上传的文件会自动在S3对象元数据和本地Blob记录的metadata字段中写入content_disposition属性。6.1版本前上传的旧文件没有这部分元数据，即使调用rails_blob_url时指定了disposition: :attachment，生成的S3预签名URL也不会自动携带下载所需的响应头参数，因此无法触发浏览器下载行为。

方案1：批量补全历史文件元数据（根治方案） #

通过Rake任务遍历所有S3存储的历史Blob，调用S3 API原地更新对象元数据，同时同步本地记录，后续即可正常使用原生rails_blob_url方法。

• 执行前建议先选取少量历史文件测试，验证下载逻辑正常后再全量运行
• 文件量较大时可分批调度任务，避免触发S3请求限流

Rake任务示例代码：

namespace :active_storage do
  desc "补全S3历史文件的Content-Disposition元数据"
  task fix_s3_content_disposition: :environment do
    # 仅遍历S3存储的Blob，可根据实际service_name调整过滤条件
    ActiveStorage::Blob.where(service_name: "amazon").find_each do |blob|
      # 跳过已存在元数据的新文件
      next if blob.metadata["content_disposition"].present?

      # 生成符合规范的attachment格式头，自动处理文件名编码
      target_disposition = ActionDispatch::Http::ContentDisposition.format(
        disposition: "attachment",
        filename: blob.filename.sanitized
      )

      # 调用S3 CopyObject接口原地更新元数据
      blob.service.s3_client.copy_object(
        bucket: blob.service.bucket.name,
        key: blob.key,
        copy_source: "#{blob.service.bucket.name}/#{blob.key}",
        content_disposition: target_disposition,
        metadata_directive: "REPLACE"
      )

      # 同步更新本地Blob的元数据记录
      blob.metadata[:content_disposition] = target_disposition
      blob.save!
    end
  end
end

方案2：动态生成带响应头覆盖的预签名URL（无侵入兼容方案） #

不需要修改S3上的历史文件，直接在生成下载链接时手动指定S3预签名的响应头参数，强制返回下载所需的Content-Disposition头。
控制器代码示例：

# 替换原有rails_blob_url跳转逻辑
s3_object = @episode.file.service.s3_bucket.object(@episode.file.key)
download_url = s3_object.presigned_url(
  :get,
  expires_in: 10.minutes.to_i,
  # 手动指定响应头覆盖S3原有的元数据配置
  response_content_disposition: ActionDispatch::Http::ContentDisposition.format(
    disposition: "attachment",
    filename: @episode.file.filename.sanitized
  )
)
redirect_to download_url, allow_other_host: true

该方案适合文件量极大、批量修改S3对象成本较高的场景，缺点是需要调整所有下载链接的生成逻辑。

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