Rails 5 多参数高级搜索实现咨询——兼容现有基础搜索功能

首先，我们要把高级搜索的逻辑完全封装在模型里，同时保留原有的基础搜索功能。下面是一步步的改造方案：

1. 重构模型的advanced_search方法 #

让这个方法接收表单提交的参数，链式构建查询条件，只处理存在的有效参数：

class Contact < ApplicationRecord
  # 保留原有的QUICK_SEARCH_FIELDS和search方法不变

  def self.advanced_search(params)
    contacts = all

    # 处理下拉选择类的精确匹配字段
    %i[contact_type prospect_strength customer_account_id supplier_account_id assigned_to].each do |field|
      contacts = contacts.where(field => params[field]) if params[field].present?
    end

    # 处理文本模糊搜索字段
    %i[company_name name title postcode].each do |field|
      if params[field].present?
        contacts = contacts.where("#{table_name}.#{field} LIKE ?", "%#{params[field]}%")
      end
    end

    # 处理日期范围筛选
    if params[:created_at].present?
      contacts = contacts.where("#{table_name}.created_at >= ?", Date.parse(params[:created_at]))
    end
    if params[:updated_at].present?
      # 注意：你的表单里该字段label写的是"Created To"，建议改成"Updated To"避免用户混淆
      contacts = contacts.where("#{table_name}.updated_at <= ?", Date.parse(params[:updated_at]))
    end

    # 处理标签筛选（基于acts_as_taggable_on）
    if params[:tag_list].present?
      # any: true 表示匹配任意一个标签；all: true 表示必须匹配所有选中标签，按需调整
      contacts = contacts.tagged_with(params[:tag_list], any: true)
    end

    # 处理Obsolete状态筛选
    if params[:obsolete].present?
      case params[:obsolete]
      when 'Obsolete'
        contacts = contacts.where(obsolete: true)
      when 'All'
        # 不做过滤，显示所有状态的联系人
      else
        # 默认显示非废弃的联系人
        contacts = contacts.where(obsolete: false)
      end
    else
      # 默认只展示非废弃的联系人，和表单提示保持一致
      contacts = contacts.where(obsolete: false)
    end

    contacts
  end
end

2. 更新控制器的index方法 #

添加高级搜索的分支判断，同时完整保留原有的基础搜索逻辑：

class ContactsController < ApplicationController
  def index
    @per_page = params[:per_page] || 20
    @tags = ActsAsTaggableOn::Tag.all

    # 判断是否触发高级搜索：排除分页、基础搜索等无关参数后，检查是否有有效筛选值
    advanced_search_triggered = params.except(:controller, :action, :page, :per_page, :qs, :search, :subsequent_action).values.any?(&:present?)

    if params[:search].present?
      # 保留原有的基础搜索逻辑
      @contacts = Contact.search(params[:qs], params[:search])
                         .order("#{sort_column} #{sort_direction}")
                         .paginate(page: params[:page], per_page: @per_page)
    elsif advanced_search_triggered
      # 调用模型层的高级搜索方法
      @contacts = Contact.advanced_search(params)
                         .order("#{sort_column} #{sort_direction}")
                         .paginate(page: params[:page], per_page: @per_page)
      # 处理表单里的后续动作（导出、报表等）
      handle_subsequent_action
    else
      # 默认展示非废弃的联系人，和高级搜索默认逻辑对齐
      @contacts = Contact.where(obsolete: false)
                         .order("#{sort_column} #{sort_direction}")
                         .paginate(page: params[:page], per_page: @per_page)
    end
  end

  private

  # 处理表单中的后续动作选项
  def handle_subsequent_action
    case params[:subsequent_action]
    when 'csv_export'
      # 示例：导出CSV，需在模型中实现to_csv方法
      send_data @contacts.to_csv, filename: "contacts-#{Date.today}.csv"
    when 'report'
      # 这里添加生成报表的业务逻辑，比如调用报表生成服务
    when 'new_event'
      # 跳转到事件创建页，携带选中的联系人ID
      redirect_to new_event_path(contact_ids: @contacts.pluck(:id))
    end
  end

  # 保留原有的sort_column和sort_direction方法不变
end

3. 关键注意事项 #

• 日期解析容错：如果用户输入非法日期格式，Date.parse会抛出错误，建议添加异常处理，或者引入chronic gem支持更灵活的日期格式解析。
• SQL注入安全：所有查询都使用了Rails的占位符?，避免了SQL注入风险，这是ORM查询的最佳实践。
• 表单标签修正：你的高级搜索表单中，updated_at字段的label是"Created To"，这是明显的笔误，建议修改为"Updated To"，避免用户误解。
• 标签匹配逻辑：tagged_with的any: true和all: true可按需切换，前者是匹配任意选中标签，后者是必须匹配所有选中标签。
• 默认状态一致性：我们在高级搜索和默认查询中都默认过滤了obsolete: false的联系人，和表单中的"Not obsolete?"提示保持逻辑一致。

这样改造后，你的高级搜索就能支持多参数组合查询，所有搜索逻辑都封装在模型层，同时完全保留了原有的基础搜索功能。

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