CarrierWave Gem 更新异常：Rails 5数组文件上传更新时文件被覆盖

我之前踩过完全一样的坑！CarrierWave 默认对数组类型的文件上传，在执行更新操作时会直接替换整个文件数组，而不是追加新文件，核心问题出在参数处理逻辑和Uploader 的挂载方式上，下面一步步给你解决：

1. 先确认你的 Uploader 和 Model 配置是否正确 #

首先要确保你用的是复数的 mount_uploaders 而不是单数的 mount_uploader，这是数组上传的核心前提：

# app/models/my_object.rb
class MyObject < ApplicationRecord
  # 注意是 mount_uploaders（复数），对应数据库里的数组字段（比如 files:json 类型）
  mount_uploaders :files, FileUploader
  serialize :files, JSON # Rails 5 里如果用 PostgreSQL 的 array 类型可以不用这个，但 JSON 类型需要
end

你的 Uploader 保持基础配置即可，不用特殊改动：

# app/uploaders/file_uploader.rb
class FileUploader < CarrierWave::Uploader::Base
  storage :file

  def store_dir
    "uploads/#{model.class.to_s.underscore}/#{mounted_as}/#{model.id}"
  end

  # 可选：限制文件类型
  def extension_allowlist
    %w(jpg jpeg png pdf)
  end
end

2. 修改 Controller 的参数处理逻辑 #

问题根源就在更新时的参数传递——直接传 my_object_params 会用新文件数组覆盖旧的，所以我们需要主动合并旧文件和新上传的文件：

# app/controllers/my_objects_controller.rb
def update
  @my_object = MyObject.find(params[:id])
  
  # 处理文件参数：合并旧文件与新上传文件
  if params[:my_object][:files].present?
    # 过滤掉新参数里的空值（比如用户没选新文件时的占位空文件）
    new_files = params[:my_object][:files].reject { |f| f.blank? }
    # 合并旧文件数组和新文件数组
    merged_files = @my_object.files + new_files
    params[:my_object][:files] = merged_files
  else
    # 如果没传新文件，直接移除files参数，避免覆盖原有数据
    params[:my_object].delete(:files)
  end

  if @my_object.update(my_object_params)
    redirect_to @my_object, notice: '更新成功'
  else
    render :edit
  end
end

private
def my_object_params
  params.require(:my_object).permit(:name, files: []) # 注意 files: [] 表示允许数组类型参数
end

3. 表单字段的正确配置 #

确保你的表单文件字段是数组形式，并且开启多文件上传：

# app/views/my_objects/_form.html.erb
<%= form_with(model: @my_object, local: true) do |form| %>
  # 其他业务字段...
  
  <%= form.label :files %>
  <%= form.file_field :files, multiple: true, name: "my_object[files][]" %>
  
  <%= form.submit %>
<% end %>

额外注意事项 #

• 如果用 PostgreSQL 的 text[] 原生数组类型，不需要在 Model 里加 serialize :files, JSON，CarrierWave 会自动适配
• 建议使用 CarrierWave 1.0 及以上版本，旧版本对数组上传的支持存在 bug
• 如果需要支持单个文件删除，还需要额外添加删除按钮逻辑，在更新时移除对应文件路径

这样修改后，执行 update_attributes（或 update）时，新上传的文件就会追加到原有文件数组后面，再也不会覆盖旧文件啦！

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