基于多字段的Rails跨表用户搜索查询方案问询

模型关联定义 #

User 模型（user.rb） #

class User < ApplicationRecord
  has_many :project_users, dependent: :destroy
  has_many :projects, through: :project_users, dependent: :destroy
end

User表字段：first_name、last_name、email（均用于搜索）

Project 模型（project.rb） #

class Project < ApplicationRecord
  belongs_to :user
  has_many :project_users, dependent: :destroy
  has_many :features, dependent: :destroy
  has_many :users, through: :project_users, source: :user
end

Project表字段：project_name（用于搜索）

Feature 模型（feature.rb） #

class Feature < ApplicationRecord
  belongs_to :project
end

Feature表字段：feature_name（用于搜索）

需求说明 #

• 搜索关键词通过params[:search_member]传递，示例值：

  params[:search_member] = "John"
  params[:search_member] = "Project1"
  params[:search_member] = "Feature1"
  params[:search_member] = "john@gmail.com"
  

• 关联逻辑：

  current_user.projects # 当前用户所属的所有项目
  project.users # 项目所属的所有用户
  feature.project # 功能所属的项目
  feature.project.users # 功能所属项目的所有用户
  

• 需要通过单一JOIN查询实现，根据关键词匹配对应字段并返回用户记录。

搜索逻辑要求 #

• 输入project_name时，返回该项目的所有用户；
• 输入first_name、last_name或email时，返回符合该信息的所有用户；
• 输入feature_name时，返回该功能所属项目的所有用户。

实现代码 #

以下是完整的search_all方法实现，通过LEFT JOIN关联相关表，用OR条件匹配所有目标字段，最后用distinct避免重复用户记录：

def search_all
  if params[:search_member].present?
    keyword = "%#{params[:search_member]}%"
    User.left_joins(projects: :features)
        .where(
          "users.first_name LIKE ? OR users.last_name LIKE ? OR users.email LIKE ? OR projects.project_name LIKE ? OR features.feature_name LIKE ?",
          keyword, keyword, keyword, keyword, keyword
        )
        .distinct
  else
    User.all
  end
end

代码说明 #

1. LEFT JOIN：使用left_joins(projects: :features)一次性关联用户的项目及项目下的功能表，确保即使用户没有关联项目/功能也能被匹配到自身字段；
2. 模糊匹配：用LIKE和通配符%实现关键词的部分匹配，适配不同的搜索场景；
3. 去重处理：添加distinct方法，避免同一用户因关联多个项目/功能而被多次返回；
4. 单一查询：所有条件整合在一个WHERE子句中，符合要求的单一查询实现。

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