Heroku上Rails5应用基于Paperclip+Delayed Job实现后台文件上传（非后处理）

我完全懂你的痛点——Heroku dyno被文件上传阻塞太闹心了，而且你还不想丢Paperclip的验证逻辑、也不想动现有的数千条存储记录，这个需求完全能实现！核心思路是先暂存文件的二进制数据到数据库，再触发后台任务调用Paperclip完成实际上传，全程保留Paperclip的验证和原有存储结构。

具体实现步骤 #

1. 给模型添加临时存储字段 #

首先需要在你用Paperclip的模型（比如Attachment）里，加几个字段用来暂存文件的核心信息：

• temp_file_data：存储文件二进制内容
• file_name：暂存原文件名
• content_type：暂存文件MIME类型

生成迁移文件：

rails generate migration AddTempFileFieldsToAttachments temp_file_data:text file_name:string content_type:string

然后执行迁移：

rails db:migrate

注：如果你的文件很大，PostgreSQL可以把temp_file_data改成bytea类型，MySQL用LONGBLOB，避免字段长度不够。

2. 修改前端与控制器，暂存文件数据 #

前端还是用常规的表单提交文件，控制器里不再直接调用Paperclip上传，而是把文件数据存到临时字段里，然后触发后台任务：

def create
  @attachment = Attachment.new(attachment_params)

  # 提取上传文件的核心信息暂存
  if params[:attachment][:file].present?
    uploaded_file = params[:attachment][:file]
    @attachment.temp_file_data = uploaded_file.read
    @attachment.file_name = uploaded_file.original_filename
    @attachment.content_type = uploaded_file.content_type
  end

  if @attachment.save
    # 触发后台上传任务
    UploadAttachmentJob.perform_later(@attachment.id)
    redirect_to @attachment, notice: '上传请求已提交，正在后台处理'
  else
    render :new
  end
end

private
def attachment_params
  params.require(:attachment).permit(:temp_file_data, :file_name, :content_type, ...# 你的其他模型字段...)
end

这一步只是写数据库，速度极快，不会阻塞Heroku web dyno。

3. 编写后台上传任务（以Sidekiq为例） #

用Sidekiq（Heroku官方推荐的后台任务处理器）编写Job，从数据库取出临时数据，模拟上传文件对象，调用Paperclip的逻辑完成实际上传，同时触发验证：

class UploadAttachmentJob
  include Sidekiq::Job

  def perform(attachment_id)
    @attachment = Attachment.find(attachment_id)
    # 跳过已处理或无临时数据的情况
    return if @attachment.file.present? || @attachment.temp_file_data.blank?

    # 构建临时文件模拟前端上传的对象
    temp_file = Tempfile.new([@attachment.file_name, File.extname(@attachment.file_name)])
    temp_file.binmode
    temp_file.write(@attachment.temp_file_data)
    temp_file.rewind

    # 用ActionDispatch上传对象包装，让Paperclip识别
    paperclip_file = ActionDispatch::Http::UploadedFile.new(
      tempfile: temp_file,
      filename: @attachment.file_name,
      type: @attachment.content_type
    )

    # 调用Paperclip的assign方法，触发验证与上传
    @attachment.file = paperclip_file

    if @attachment.save!
      # 上传成功后清理临时字段
      @attachment.update!(temp_file_data: nil, file_name: nil, content_type: nil)
      Rails.logger.info "Attachment #{attachment_id} uploaded successfully"
    end

    # 清理临时文件
    temp_file.close
    temp_file.unlink
  rescue ActiveRecord::RecordNotFound => e
    Rails.logger.error "Attachment #{attachment_id} not found: #{e.message}"
  rescue ActiveRecord::RecordInvalid => e
    Rails.logger.error "Attachment #{attachment_id} validation failed: #{e.message}"
    # 这里可以加通知逻辑，比如给用户发邮件告知上传失败
  end
end

4. 保留Paperclip的验证逻辑 #

你原来在模型里写的Paperclip验证（比如文件类型、大小验证）完全不需要修改，因为在后台任务里调用@attachment.file = paperclip_file和save!时，Paperclip会自动触发所有验证规则。如果验证不通过，save!会抛出RecordInvalid异常，你可以在Job里捕获并处理（比如记录日志、通知用户）。

5. Heroku环境配置 #

• 确保你已经部署了Sidekiq（或其他后台处理器）：在Heroku添加Sidekiq的gem，配置Procfile，比如：

  web: bundle exec puma -C config/puma.rb
  worker: bundle exec sidekiq
  

• 启动worker dyno：

  heroku ps:scale worker=1
  

• 注意：Heroku的临时文件系统不会影响这个方案，因为我们的Tempfile只在Job执行期间存在，执行完就会被删除。

为什么这个方案适合你？ #

• 完全保留Paperclip的所有验证功能，不用重构现有验证逻辑
• 不改变现有存储结构和记录ID，数千条历史文件不受影响
• 彻底把文件上传的IO操作从web dyno转移到worker dyno，避免阻塞

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