Rails ActiveStorage未上传文件时随机关联本地文件如何解决

问题成因排查与解决步骤 #

1. 移除模型层的自动附件赋值逻辑

先检查Image模型是否存在未展示的回调逻辑，比如after_initialize类的初始化回调中包含自动挂载本地图片的代码：

# 如果你有类似下面的代码请删除或调整
after_initialize :set_default_picture, if: :new_record?
def set_default_picture
  # 这类自动attach的逻辑会导致空提交时自动关联本地图片
  self.picture.attach(io: File.open(Rails.root.join("app/assets/images/default.jpg")), filename: "default.jpg")
end

如果需要展示默认占位图，不要在模型层自动挂载附件，改为视图层判断即可：

<%# 视图中显示图片的位置改为如下逻辑 %>
<% if @image.picture.attached? %>
  <%= image_tag @image.picture %>
<% else %>
  <%= image_tag "default_placeholder.png" %>
<% end %>

2. 增加模型校验避免空提交

如果业务要求每条Image记录必须绑定图片，在模型中增加附件校验规则，空提交时会直接触发错误拦截，不会进入保存流程：

class Image < ApplicationRecord
  belongs_to :user
  has_one_attached :picture
  # 新增校验规则
  validates :picture, presence: true,
            content_type: ["image/png", "image/jpeg", "image/jpg"],
            size: { less_than: 5.megabytes }
end

该校验也可以替换你前端写的文件大小判断逻辑，前后端双重校验更稳妥。

3. 修正表单参数传递配置

确认表单支持文件上传参数传递，将表单首行修改为：

<%= form_with(model: image, local: true, multipart: true) do |form| %>

避免异步提交时的参数异常导致错误关联附件。

4. 清理开发环境残留附件

如果是开发环境下有大量未关联的遗留附件，可以执行命令清理无效的ActiveStorage记录：

rails active_storage:purge_unattached

清理后再测试提交，排除残留数据干扰。

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