Rails 5中HABTM关联预加载与Bullet gem兼容问题咨询

我太懂你这种困扰了——明明已经用了预加载，Bullet却一个劲提示N+1查询，尤其是HABTM这种关联，在Rails 5里确实容易和Bullet的检测逻辑“不对付”。咱们来一步步搞定这个问题：

1. 明确使用preload而非includes #

Rails的includes会自动选择预加载策略，但HABTM关联的结构有时候会让它切换到eager_load（左连接查询），而Bullet对这种复杂连接的预加载识别不太准确。改用preload强制分步骤查询，Bullet就能正确识别到你已经预加载了关联：

# 替换原来的includes为preload
SourcedContact.preload(contact: [:companies, :email_addresses, :phone_numbers, :addresses]).all

preload会先查询所有SourcedContact，再批量查询关联的Contact，最后分别批量查询每个Contact对应的HABTM关联数据，这种清晰的分步查询逻辑Bullet完全能识别，不会再误报N+1。

2. 给Bullet添加白名单（应急方案） #

如果上面的方法还是没能让Bullet“闭嘴”，那大概率是它的误判。这时候可以在Bullet的初始化配置文件（config/initializers/bullet.rb）里添加白名单，忽略这些HABTM关联的N+1提示：

# 针对每个HABTM关联添加白名单
Bullet.add_whitelist type: :n_plus_one_query, class_name: 'Contact', association: :companies
Bullet.add_whitelist type: :n_plus_one_query, class_name: 'Contact', association: :email_addresses
Bullet.add_whitelist type: :n_plus_one_query, class_name: 'Contact', association: :phone_numbers
Bullet.add_whitelist type: :n_plus_one_query, class_name: 'Contact', association: :addresses

⚠️ 注意：这只是临时的应急手段，尽量先尝试第一种方法，白名单只是掩盖提示，并没有优化查询逻辑。

3. 长期方案：将HABTM转为has_many :through关联 #

HABTM是Rails比较早期的关联方式，灵活性差，而且很多工具（包括Bullet）对has_many :through的支持更友好——因为中间有明确的关联模型。

比如把Contact和Company的HABTM改成：

# 先生成中间模型（对应已有的companies_contacts表）
class CompanyContact < ActiveRecord::Base
  belongs_to :contact
  belongs_to :company
end

# 修改Contact模型的关联
class Contact < ActiveRecord::Base
  has_many :company_contacts
  has_many :companies, through: :company_contacts
  
  # 同理修改其他HABTM关联：
  has_many :contact_email_addresses
  has_many :email_addresses, through: :contact_email_addresses
  
  has_many :contact_phone_numbers
  has_many :phone_numbers, through: :contact_phone_numbers
  
  has_many :contact_addresses
  has_many :addresses, through: :contact_addresses
end

改成has_many :through后，无论用includes还是preload，Bullet都能准确识别预加载的关联，而且后续你要给中间表加额外字段（比如关联创建时间、备注）也更方便，一举两得。

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