Rails模型Scope中includes预加载关联失败问题求助

我来帮你排查下这个问题，主要从确保Scope预加载逻辑正确和JSON序列化时包含关联数据两个核心点入手：

1. 修正Search Scope的写法 #

你当前的includes(:author)本身是正确的，但可以优化写法，同时规避潜在的SQL注入风险，确保预加载逻辑稳定生效：

scope :search, ->(title) {
  includes(:author)
    .where("title % :title", title: title)
    .order(Arel.sql("similarity(title, ?) DESC", title)) # 用参数化替代手动拼接字符串，更安全
}

调整说明： #

• 移除了手动调用quote_string的操作，改用Arel.sql的参数化传参，既避免SQL注入风险，也能让ActiveRecord正确处理字符串转义逻辑。
• 将includes(:author)放在链式调用的最前端，写法更清晰，也能避免后续的where/order操作意外干扰预加载的触发（虽然理论上顺序不影响，但这样的写法更符合Rails最佳实践）。

2. 确保JSON序列化时包含关联数据 #

即使你已经成功预加载了author关联，默认的to_json方法不会自动包含关联对象，这会让你误以为关联没加载。所以在控制器的render步骤，需要明确指定要包含author：

def search
  results_books = Book.search(search_params[:q]).first(5)
  results_authors = Author.search(search_params[:q]).first(5)
  results = results_books + results_authors
  
  # 序列化时明确指定包含books的author关联
  render json: { 
    results: results.as_json(include: [:author])
  }, status: :ok
end

额外提示： #

如果你的Author模型也有需要一并返回的关联字段，可以进一步细化as_json的配置，比如include: { author: [:books] }，根据你的业务需求调整即可。

3. 验证预加载是否生效 #

你可以在Rails控制台里测试，查看SQL日志是否只执行两次查询（一次查books，一次批量查对应的authors），以此确认预加载成功：

# 控制台测试示例
books = Book.search("test").first(5)
books.each { |b| puts b.author.name } # 观察日志，若只执行两次SQL则预加载生效

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