基于Ransack的多Class搜索表单技术咨询

看起来你已经用Ransack搭好了单模型的搜索表单，但现在需要扩展到跨两个独立类的联合搜索场景。下面我会分享两种最常用的解决方案，适配不同的模型关系情况：

方案一：无关联模型的独立搜索+结果合并 #

如果你的两个模型没有直接关联关系（比如一个是Article，另一个是Product），最直接的方式是分别为每个模型创建Ransack搜索对象，在表单中区分参数命名空间，最后合并搜索结果。

1. 控制器层处理逻辑 #

假设你的两个目标模型是TaggableItem（对应tags_id_in字段）和SectorRelatedItem（对应sector_id_eq字段），在控制器的搜索action中：

def index
  # 处理第一个模型的搜索参数
  @q_taggable = TaggableItem.ransack(params[:q_taggable])
  # 参数为空时返回所有记录，也可改成.none只返回有筛选的结果
  @taggable_results = @q_taggable.result(distinct: true)

  # 处理第二个模型的搜索参数
  @q_sector = SectorRelatedItem.ransack(params[:q_sector])
  @sector_results = @q_sector.result(distinct: true)

  # 合并两个模型的结果，根据需求选择去重方式
  @combined_results = @taggable_results + @sector_results
end

2. 调整搜索表单 #

因为要同时处理两个模型的搜索参数，我们不能再用绑定单个Ransack对象的search_form_for，改用普通的form_tag并手动指定参数命名空间：

<%= form_tag your_search_path, method: :get do %>
  <!-- 第一个模型的Tags筛选 -->
  <%= label_tag 'q_taggable[tags_id_in]', 'Tags' %>
  <%= select_tag 'q_taggable[tags_id_in]', 
    options_for_select(Tag.all.map{ |tag| [tag.name, tag.id] }, params.dig(:q_taggable, :tags_id_in)), 
    include_blank: "Select Tags" %>

  <!-- 第二个模型的Sector筛选 -->
  <%= label_tag 'q_sector[sector_id_eq]', 'Sector' %>
  <%= select_tag 'q_sector[sector_id_eq]', 
    options_for_select(Sector.all.map{ |sector| [sector.name, sector.id] }, params.dig(:q_sector, :sector_id_eq)), 
    include_blank: 'Any Sector' %>

  <%= submit_tag "Search" %>
<% end %>

3. 优化空参数处理 #

如果希望用户只填写一个筛选条件时，另一个模型不返回任何结果（而非全部记录），可以在控制器里添加判断：

@taggable_results = params[:q_taggable].present? ? @q_taggable.result(distinct: true) : TaggableItem.none
@sector_results = params[:q_sector].present? ? @q_sector.result(distinct: true) : SectorRelatedItem.none

方案二：利用模型关联/父类统一搜索 #

如果你的两个模型有共同的父模型（比如通过单表继承STI），或者存在关联关系（比如都属于同一个Project），可以在父模型/关联根节点上构建Ransack搜索，这样就能复用你熟悉的search_form_for。

示例：基于父模型的搜索 #

假设两个模型都继承自BaseItem：

class BaseItem < ApplicationRecord
  self.abstract_class = true
end

class TaggableItem < BaseItem
  has_many :tags
end

class SectorRelatedItem < BaseItem
  belongs_to :sector
end

控制器中直接使用父模型创建Ransack对象：

def index
  @q = BaseItem.ransack(params[:q])
  @combined_results = @q.result(distinct: true)
end

表单可以复用你原来的结构，只需确保字段对应父模型的可搜索属性/关联：

<%= search_form_for @q do |f| %>
  <%= f.label :tags_id_in, 'Tags' %>
  <%= f.select :tags_id_in, Tag.all.map{ |u| [u.name, u.id] }, { include_blank: "Tags" } %>
  
  <%= f.label :sector_id_eq, 'Sector' %>
  <%= f.select :sector_id_eq, Sector.all.map { |w| [w.name, w.id] }, {include_blank: 'Any'} %>
  
  <%= f.submit "Search" %>
<% end %>

关键注意点 #

• 确保两个模型都配置了Ransack的可搜索属性/关联，避免权限错误：

class TaggableItem < BaseItem
  ransackable_attributes %w[id name] # 允许搜索的属性
  ransackable_associations %w[tags] # 允许搜索的关联
end

class SectorRelatedItem < BaseItem
  ransackable_attributes %w[id name]
  ransackable_associations %w[sector]
end

内容的提问来源于stack exchange，提问作者Brian O Halloran