ActiveRecord查询添加join和group语句后分页失效是什么原因？

核心原因 #

• 分组查询导致分页总计数异常
  你使用group做聚合查询后，ActiveRecord默认的count方法会返回按分组键统计的哈希结构（格式为{ 订阅ID => 对应版本数 }），而非分页插件需要的总条目整数值。will_paginate、Kaminari等分页组件计算总页数时依赖整数类型的总计数，拿到哈希后无法正常计算页数，就会出现分页错乱、页数显示错误的问题。
• INNER JOIN过滤了无版本的订阅
  如果存在没有关联任何SubscriptionVersions的订阅记录，INNER JOIN会直接排除这部分数据，导致实际查询到的订阅总数少于预期，也会表现为分页异常。
• 分组字段的数据库兼容性问题
  开启ONLY_FULL_GROUP_BY约束的MySQL、PostgreSQL等数据库，要求SELECT子句中所有非聚合字段都必须出现在GROUP BY列表中。如果你查询返回的字段包含plans、subscriptions、users表中未在GROUP BY声明的字段，部分数据库会隐式处理或报错，也可能干扰分页逻辑。

修复方案 #

方案1：子查询排序（最简洁，推荐） #

不需要JOIN和GROUP，直接用子查询做排序，完全避免分页计数问题，给subscription_versions表加subscription_id, authorized_at联合索引后性能极佳：

def index
  @subscriptions = current_account.subscriptions
    .includes(:plan, :user)
    .order(Arel.sql("(SELECT MAX(authorized_at) FROM subscription_versions WHERE subscription_versions.subscription_id = subscriptions.id) ASC"))
    .paginate(page: params[:page], per_page: 20)
end

方案2：窗口函数实现排序 #

如果需要保留关联查询逻辑，用窗口函数替代GROUP，避免计数异常：

def index
  @subscriptions = current_account.subscriptions
    .includes(:plan, :user)
    .left_joins(:subscription_versions) # 保留无版本的订阅，不需要可以换成joins
    .select("subscriptions.*, MAX(subscription_versions.authorized_at) OVER (PARTITION BY subscriptions.id) AS latest_authorized_at")
    .order("latest_authorized_at ASC NULLS LAST") # NULLS LAST将无版本的订阅放在末尾
    .distinct
    .paginate(page: params[:page], per_page: 20)
end

方案3：手动指定总条目数（兼容现有写法） #

如果不想修改原有查询逻辑，手动给分页插件传入正确的总计数即可：

def index
  subscription_scope = current_account.subscriptions
    .includes(:plan, :user)
    .joins("INNER JOIN subscription_versions ON subscription_versions.subscription_id = subscriptions.id")
    .group("plans.id, subscriptions.id, users.id")
    .order("MAX(subscription_versions.authorized_at) ASC")
  # 手动计算正确的总条目数
  total_count = subscription_scope.count.keys.size
  @subscriptions = subscription_scope.paginate(page: params[:page], per_page: 20, total_entries: total_count)
end

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