如何修复N+1查询：在JSON API响应中限制子关联为最新记录

我完全懂你的困扰——要返回父记录列表，同时带上每个父对应的最新子记录，逻辑本身能返回正确的JSON，但每次请求都触发讨厌的Task N+1查询，试了链式作用域、includes加limit都没解决，还不想用JSON序列化器。下面给你几个不用序列化器就能搞定的方案，都是通过模型关联优化和SQL技巧来解决的：

方案1：用子查询定义has_one关联 #

这种方法适配大多数数据库（MySQL、PostgreSQL都支持），核心是通过子查询直接定位每个父记录对应的最新子记录ID，再关联到该子记录。

假设你的父模型是Project，子模型是Task（Task包含project_id外键和created_at字段），在Project模型里定义关联：

# app/models/project.rb
has_one :most_recent_task, -> {
  # 子查询获取当前project对应的最新task的ID（用MAX(id)是因为自增ID的最新记录ID最大）
  where(id: Task.select('MAX(id)').where('tasks.project_id = projects.id'))
}, class_name: 'Task'

如果你的排序依据不是ID（比如用updated_at），可以把子查询改成Task.select('id').order(updated_at: :desc).limit(1)，不过MAX(id)的性能会更优。

然后在控制器里直接用includes预加载这个关联：

# app/controllers/projects_controller.rb
def index
  @projects = Project.includes(:most_recent_task).all
  render json: @projects.as_json(include: :most_recent_task)
end

这样只会触发两次查询：一次查询所有Project，一次查询所有Project对应的最新Task，完美解决N+1问题。

方案2：用PostgreSQL窗口函数（适合PostgreSQL环境） #

如果你的项目用PostgreSQL，窗口函数是更灵活的方案，尤其适合按非自增字段排序的场景（比如按updated_at或自定义优先级排序）。

首先在Task模型里定义一个作用域，筛选每个父记录的最新子记录：

# app/models/task.rb
scope :latest_per_parent, -> {
  select('tasks.*')
    .from(
      <<~SQL
        (SELECT tasks.*,
                ROW_NUMBER() OVER(PARTITION BY tasks.project_id ORDER BY tasks.created_at DESC) AS rn
         FROM tasks) AS tasks
      SQL
    )
    .where(rn: 1)
}

这段SQL里，PARTITION BY tasks.project_id会把Task按project分组，ROW_NUMBER()给每个分组内的记录按created_at倒序编号，取编号为1的就是每个project的最新Task。

接着在Project模型里关联这个作用域：

# app/models/project.rb
has_one :most_recent_task, -> { merge(Task.latest_per_parent) }, class_name: 'Task'

控制器里同样用includes预加载即可：

def index
  @projects = Project.includes(:most_recent_task).all
  render json: @projects.as_json(include: :most_recent_task)
end

这种方法的优势是排序逻辑更灵活，只要调整ORDER BY部分就能适配不同的排序需求。

为什么之前的includes+limit没生效？ #

你之前尝试的includes加limit没用，是因为Rails的includes对带limit的关联无法批量预加载——它没办法一次性获取所有父记录对应的“最新一条”子记录，只能在遍历每个父记录时单独发起查询，这就导致了N+1问题。而上面的两种方案，都是通过子查询或窗口函数让Rails能一次性获取所有需要的最新子记录，所以includes能正常工作。

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