ActiveStorage附件存在但Datagrid列显示nil问题排查

这个问题的核心出在两个地方：Active Storage附件的预加载缺失，以及视图代码的语法错误，导致attached?返回false且无法正确渲染图片。

1. 为什么record.avatar.attached?返回false？ #

你在Datagrid的scope里用了User.joins(:avatar_attachment)，这确实能过滤出带有附件的用户，但joins只做了SQL内连接，不会预加载Active Storage的附件关联。当你在column块里访问record.avatar时，Rails需要单独查询每个用户的附件数据，而Datagrid的上下文可能导致这个查询没有正确执行，最终attached?无法识别到已存在的附件，返回false。

2. 视图代码的语法错误 #

你在link_to里把image_tag(url_for(record.avatar))写成了字符串，这会直接输出这段文本，而不是执行image_tag方法生成图片标签。

修正后的完整代码 #

class UserGrid
  scope do
    # 用joins过滤有附件的用户，同时用includes预加载附件关联，避免N+1查询并让attached?正确识别
    User.joins(:avatar_attachment).includes(:avatar_attachment)
  end

  column(:avatar, html: true, header: 'Avatar') do |record|
    if record.avatar.attached?
      # 正确调用image_tag方法，生成图片链接
      concat link_to(
        image_tag(url_for(record.avatar)), 
        record.avatar_url.presence || url_for(record.avatar), 
        target: '_blank'
      )
    end
  end
end

额外说明 #

• 预加载的重要性：includes(:avatar_attachment)会把所有用户的附件数据一次性加载到内存中，不仅解决了attached?返回false的问题，还避免了大量重复的SQL查询（N+1问题），提升页面性能。
• URL的兼容性：如果你的User模型没有定义avatar_url方法，可以直接用url_for(record.avatar)替代，它会生成Active Storage附件的正确访问链接。

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