Rails、Arel与作用域：简化同表字段多OR匹配逻辑

嘿，我来帮你解决这个重复代码的痛点！针对Rails API里客户表多字段模糊匹配的需求，不管是最初的传统写法还是Arel实现，都能大幅简化，咱们具体来看：

之前你可能会写一堆重复的LIKE条件，比如：

Customer.where("name LIKE ? OR email LIKE ? OR phone LIKE ? OR address LIKE ? OR company LIKE ?", "%#{q}%", "%#{q}%", "%#{q}%", "%#{q}%", "%#{q}%")

这种写法不仅冗余，后续加字段还要改两处（条件字符串和参数）。咱们可以把字段名放到数组里，动态生成条件：

def search_customers(query)
  return Customer.all if query.blank?
  
  # 定义需要匹配的字段集合，后续改字段只动这里
  search_fields = [:name, :email, :phone, :address, :company]
  
  # 动态拼接OR条件字符串
  like_clauses = search_fields.map { |field| "#{field} LIKE ?" }.join(" OR ")
  # 生成对应的参数数组
  like_params = search_fields.map { "%#{query}%" }
  
  Customer.where(like_clauses, *like_params)
end

这样维护起来只需要修改search_fields数组，完全消除重复代码。

如果用Arel的话，原来可能会逐个字段写matches然后手动or连接，同样重复。咱们可以用数组遍历+inject来合并条件：

def search_customers(query)
  return Customer.all if query.blank?
  
  customer_table = Customer.arel_table
  search_fields = [:name, :email, :phone, :address, :company]
  
  # 遍历字段生成每个字段的匹配条件，再用inject(:or)合并所有OR条件
  search_conditions = search_fields.map do |field|
    customer_table[field].matches("%#{query}%")
  end.inject(:or)
  
  Customer.where(search_conditions)
end

要是想更通用，还可以封装成模型的scope，这样控制器里调用更简洁：

class Customer < ApplicationRecord
  scope :search_any_field, ->(query) do
    return all if query.blank?
    
    table = arel_table
    search_fields = [:name, :email, :phone, :address, :company]
    conditions = search_fields.map { |f| table[f].matches("%#{query}%") }.inject(:or)
    
    where(conditions)
  end
end

之后在控制器里直接用：

@customers = Customer.search_any_field(params[:search_query])

另外提个小细节：如果需要大小写不敏感的匹配（比如PostgreSQL环境），可以把matches换成ilike方法（Rails 6+支持），或者用matches("%#{query}%", nil, true)来开启不敏感匹配。

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