分页总数虚高和数据跨页重复源于多表JOIN后分页插件对COUNT()的机械统计;PageHelper生成的COUNT()查询统计JOIN后的物理行数,而非业务主表逻辑行数。

分页总数虚高、数据跨页重复,基本就是多表JOIN后直接交给分页插件统计导致的——它对COUNT(*)不做语义识别,只机械地数JOIN后的物理行数。
PageHelper等插件的COUNT(*)查的是什么
PageHelper执行分页时,会自动把你的查询SQL改写成COUNT(*)子查询。比如你写的是:
SELECT o.id, o.order_no, i.item_name FROM orders o LEFT JOIN order_items i ON o.id = i.order_id
它生成的count语句就是:
SELECT COUNT(*) FROM orders o LEFT JOIN order_items i ON o.id = i.order_id
如果1个订单有3条明细,这条COUNT就返回3,而不是1。总数自然虚高,分页页码和每页条数全乱套。
- 它不关心你业务上“一页展示几个订单”,只数“结果集有多少行”
- 哪怕你在
resultMap里用<collection></collection>做了对象组装,count阶段根本没走到那一步 - MySQL 8.0+或PostgreSQL里,这个COUNT甚至可能触发临时表或文件排序,进一步拖慢count性能
主表分页 + 批量IN查关联数据(推荐)
绕开JOIN分页陷阱最稳的方式:先分页查主表ID,再用这批ID批量拉子表数据,最后在应用层拼装。MyBatis里可这样拆:
- 第一步:查订单分页(无JOIN)
SELECT id, order_no, amount FROM orders WHERE ... ORDER BY create_time DESC LIMIT #{offset}, #{size} - 第二步:拿到返回的
id列表(比如[101,102,103]),用SELECT * FROM order_items WHERE order_id IN (101,102,103)查明细 - 第三步:Java里用
Map<long list>></long>按order_id归组,注入到Order对象中
好处是count准确(只查orders表)、内存可控(IN列表长度可控)、明细不会跨页重复;缺点是多一次DB查询,但比错页、漏数、用户投诉成本低得多。
自定义COUNT SQL(折中方案)
如果你不能改调用逻辑,又必须用PageHelper,就得手动覆盖它的count语句。在Mapper XML里加一个同名的count语句:
<select id="selectOrderList_COUNT" resultType="java.lang.Long"><br> SELECT COUNT(*) FROM orders WHERE status = #{status}<br></select>注意:id必须是原查询ID加_COUNT后缀,且参数名、类型要完全一致。PageHelper检测到这个方法就会优先用它,跳过自动生成逻辑。
- 别写
SELECT COUNT(DISTINCT o.id)——虽然也能压回主表数量,但DISTINCT在大表上极慢,还可能因索引缺失走全表扫描 - WHERE条件必须和主查询完全同步,否则count和data不一致,分页会错位
- 测试时务必对比
PageInfo.getTotal()和SELECT COUNT(*) FROM orders WHERE ...的手动结果
为什么DISTINCT或GROUP BY不能直接救场
有人试过在原SQL末尾加GROUP BY o.id或DISTINCT o.id,发现count还是不准,甚至报错。这是因为:
-
DISTINCT *去重的是整行,而JOIN后o.id相同、i.item_name不同的行会被视为不同行,去重无效 -
GROUP BY o.id在分页插件的count阶段不生效——count语句里没有SELECT字段,GROUP BY语法非法 - 就算硬加上,MySQL 5.7+默认开启
only_full_group_by,SELECT o.id, i.item_name GROUP BY o.id会直接报错
真正容易被忽略的点是:PageHelper的count和data是两条独立SQL,它们共享参数但不共享执行上下文。任何试图在单条SQL里“既JOIN又精确计数”的尝试,本质都在对抗分页插件的设计前提——它只保证count和data的参数一致,不保证语义一致。

















