使用Active Storage附件时遭遇N+1查询问题求解

问题场景 #

我在Rails 6项目中使用Active Storage处理用户附件，模型定义如下：

class User < ApplicationRecord
  has_many_attached :resumes, dependent: :destroy
  has_many_attached :cover_letters, dependent: :destroy
end

在ResumesController的create动作中，我尝试预加载resumes相关的关联来避免N+1：

def create
  @user = User.includes(resumes_attachments: :blob).find(params[:user_id])

  if @user.resumes.attach(params[:user][:resume])
    redirect_to new_user_resume_path(@user)
  else
    render :new
  end
end

但遇到了以下问题：

• 仅当create动作失败、触发render :new时，Bullet gem会报N+1查询错误；
• 动作成功时虽然无Bullet报错，但服务器日志显示ActiveStorage::Blob被重复查询；
• 尝试使用User.with_attached_resumes.find(id)预加载，问题依旧；
• 注释掉视图所有内容后，问题仍然存在。

最终我通过同时预加载cover_letters的关联解决了问题：

# 方法一：显式includes两个附件关联
@user = User.includes(resumes_attachments: :blob, cover_letters_attachments: :blob).find(params[:user_id])

# 方法二：使用Active Storage提供的预加载方法
@user = User.with_attached_resumes.with_attached_cover_letters.find(params[:user_id])

但我不清楚为何必须同时包含cover_letters的关联，才能解决仅针对resume的N+1问题。

原因分析 #

这个现象和Rails 6中Active Storage的内部实现机制有关：

1. has_many_attached的关联结构：每个has_many_attached会为模型生成两个关联：比如resumes_attachments（关联ActiveStorage::Attachment）和resumes（附件集合代理）。
2. Attach失败后的状态检查：当调用@user.resumes.attach失败时（比如文件不符合验证规则），模型会保留错误状态。此时Active Storage的内部逻辑会遍历模型上所有的has_many_attached关联——它需要验证或同步所有附件的状态，确保模型数据的一致性。
3. 懒加载触发N+1：如果你只预加载了resumes_attachments: :blob，未预加载的cover_letters_attachments及其对应的blob会被触发懒加载，每次访问都会生成单条查询，最终导致N+1问题。

而动作成功时的重复查询，是因为attach成功后Active Storage的回调逻辑仍然会访问附件关联，但由于成功后是redirect，模型不会被后续视图复用，所以Bullet没有报错，但日志能看到查询记录。

解决方案验证 #

你使用的两种方法都能解决问题，本质是预加载了所有需要的关联数据：

• includes(resumes_attachments: :blob, cover_letters_attachments: :blob)：显式指定所有附件的关联链，确保ActiveStorage::Attachment和对应的ActiveStorage::Blob都被批量加载；
• with_attached_resumes.with_attached_cover_letters：Active Storage提供的便捷预加载方法，内部已经封装了对attachments和blob的预加载，写法更简洁。

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