Rails 7 has_many_attached上传新文件时旧文件被删除的问题

问题原因 #

在Rails 7中，当通过update方法直接给has_many_attached类型的属性赋值单个文件时，Active Storage会默认替换整个附件集合，自动删除所有旧附件。这是因为Rails 7移除了Rails 5-6中的config.active_storage.replace_on_assign_to_many = false配置，当前默认行为就是替换集合。

你的代码中，profiles_params允许的:photos是单个值，提交时传递的也是单个上传文件，触发了集合替换逻辑，所以日志中出现了旧附件的Destroy操作。

解决方案（保留旧图，追加新图） #

1. 更新参数白名单 #

修改控制器中的profiles_params，将:photos改为数组形式，确保Rails能正确接收多文件参数：

def profiles_params
  params.require(:profile).permit(
    :id, :email, :marketing, :marketing_second, :terms, 
    :personal_data, :birthdate, :avatar, photos: []
  )
end

2. 优化视图上传控件 #

在视图的file_field中添加multiple: true，支持一次上传多张图片（即使你单次只传一张，数组格式的参数也能避免触发集合替换）：

<%= form_for @profile do |f| %>  
  <div class='upload_container'>
    <%= f.file_field :photos, accept:'image/*', 
        class:'file_field_custom', required: true, multiple: true %>
    <%= f.button "Upload", type:'submit', class:'photos_submit_button' %>
  </div>
<% end %>

3. 调整控制器更新逻辑 #

不要通过update方法直接赋值photos，而是单独调用attach方法追加新图片，避免替换整个集合：

def update
  Rails.logger.debug params.inspect
  @profile = current_user.profile
  
  # 更新除图片外的其他属性
  @profile.update(profiles_params.except(:photos))
  
  # 追加新上传的图片
  if params[:profile][:photos].present?
    @profile.photos.attach(params[:profile][:photos])
  end
  
  # 自定义响应逻辑，比如重定向到详情页
  redirect_to @profile, notice: "Profile updated successfully"
end

验证修改效果 #

修改完成后重新上传图片，查看日志会发现不再出现ActiveStorage::Attachment Destroy操作，而是新增ActiveStorage::Attachment Create，旧图片会被保留，新图片成功追加到集合中。

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