对记录集合使用will_paginate时分页结果总数异常是什么原因？

AI 小北

2026-9-23

问题根因

你遇到的分页结果少于预期的核心是左外连接产生重复父记录 + ActiveRecord 实例化自动去重共同导致的，具体流程如下：

你在查询中调用了includes(:first_version_with_current_plan)，同时后续order使用了关联表subscription_carts的字段，ActiveRecord 会自动将includes转换为eager_load，也就是生成LEFT OUTER JOIN subscription_carts的SQL语句关联两个表
当一个Subscription对应多条符合关联条件的SubscriptionCart记录时，连接后的结果集会产生多条相同Subscription主键的重复行
will_paginate的分页逻辑是对连接后的原始结果集做limit + offset截取，比如你取第一页20条，拿到的是连接后的20行数据
ActiveRecord 在把查询结果实例化为Subscription对象时，会自动按主键去重，所以20行重复的结果最终可能只对应不到10个唯一的Subscription对象，就出现了你看到的分页结果不足的问题
而你之前调用count返回50是因为ActiveRecord对带join的计数查询默认会用COUNT(DISTINCT subscriptions.id)，统计的是唯一父记录的数量，和实际实例化后的集合大小不一致。

解决方案

方案1：显式去重 + 稳定排序（最通用）

如果你的业务确实需要按subscription_carts.authorized_at排序，直接在查询中加distinct避免重复行即可，同时显式指定空值的排序规则保证排序稳定性：

def index
  # PostgreSQL 写法
  @subscriptions = current_account.subscriptions
    .eager_load(:first_version_with_current_plan)
    .distinct
    .order("subscription_carts.authorized_at ASC NULLS LAST", "subscriptions.id ASC")
    .paginate(page: params[:page], per_page: 20)
end

如果使用MySQL，调整排序逻辑适配MySQL的空值排序规则：

def index
  # MySQL 写法
  @subscriptions = current_account.subscriptions
    .eager_load(:first_version_with_current_plan)
    .distinct
    .order("ISNULL(subscription_carts.authorized_at) ASC, subscription_carts.authorized_at ASC, subscriptions.id ASC")
    .paginate(page: params[:page], per_page: 20)
end

方案2：去掉关联表排序

如果你的业务不需要整个列表按购物车的授权时间排序，只是关联本身需要取最早的购物车记录，直接把order中的关联表字段移除，改用Subscription自身的字段排序即可。此时includes不会触发左外连接，不会产生重复行，分页自然正常。

方案3：子查询优化（适合大数据量场景）

如果数据量较大，join+distinct性能不好，可以用子查询先算出每个Subscription对应的最早授权时间，再基于子查询排序，避免join产生的重复行问题。

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