MyBatis-Plus多表关联分页查询问题解析与解决方案

MyBatis-Plus多表关联分页查询问题解析与解决方案

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus

问题背景

在使用MyBatis-Plus进行多表关联查询时，特别是处理一对多关系时，开发者经常会遇到分页结果不准确的问题。具体表现为：total总数正确，但返回的records记录数与预期不符。这种情况通常发生在主表与子表是一对多关系时，MyBatis-Plus的分页机制可能会产生混淆。

问题现象

当执行一个包含左连接的多表查询时，例如主表biz_activity_item与子表biz_activity的一对多关联查询，分页结果会出现以下异常情况：

1. 总记录数(total)显示正确（如15条）
2. 但实际返回的记录(records)数量与预期不符
3. 分页似乎是以子表而非主表为基准进行的

问题根源分析

这个问题的本质在于MyBatis-Plus的分页机制在处理多表关联时的局限性：

1. SQL执行机制：MyBatis-Plus的分页查询实际上是先执行COUNT查询获取总数，再执行LIMIT分页查询
2. 一对多关系影响：当主表与子表是一对多关系时，关联查询会产生多行结果（主表的一条记录可能对应子表的多条记录）
3. 分页基准混淆：LIMIT分页操作是基于关联后的结果集进行的，而不是基于主表记录数

解决方案

方案一：先分页主表再关联查询（推荐）

最可靠的解决方案是分两步进行：

1. 先对主表进行分页查询
2. 再根据主表结果关联查询子表数据

// 1. 先查询主表分页
Page<ActivityItem> mainPage = activityItemMapper.selectPage(pageQuery.build(), wrapper);

// 2. 获取主表ID集合
List<Long> mainIds = mainPage.getRecords().stream()
    .map(ActivityItem::getActivityItemId)
    .collect(Collectors.toList());

// 3. 根据主表ID关联查询子表数据
if (!mainIds.isEmpty()) {
    List<ActivityItem> fullData = activityItemMapper.selectWithDetails(mainIds);
    // 将关联数据设置到主表对象中
    // ...
}

方案二：使用子查询优化

在SQL层面使用子查询先限制主表范围：

SELECT bai.activity_item_id, bai.title, bas.activity_id, ba.title ba_title
FROM (
    SELECT activity_item_id, title 
    FROM `biz_activity_item` 
    ORDER BY activity_item_id DESC 
    LIMIT #{offset}, #{pageSize}
) bai
LEFT JOIN `biz_activity` ba ON bai.activity_item_id = ba.activity_item_id
LEFT JOIN `biz_activity_shop` bas ON ba.activity_id = bas.activity_id

方案三：内存分页处理

对于数据量不大的情况，可以在内存中处理：

1. 查询所有关联数据
2. 在Java代码中按主表ID分组
3. 手动实现分页逻辑

最佳实践建议

1. 明确分页主体：始终明确分页是针对哪个实体进行的
2. 避免复杂关联分页：尽量减少在分页查询中使用复杂关联
3. 考虑性能影响：多表关联分页可能带来性能问题，需评估数据量
4. 使用DTO投影：考虑使用专门的DTO来接收分页结果，而非直接使用实体类

总结

MyBatis-Plus多表关联分页查询的问题核心在于理解分页操作的执行机制和关联查询的结果集特性。通过先分页主表再关联查询的方式，可以有效地解决这个问题，保证分页结果的准确性。在实际开发中，应根据业务需求和数据规模选择最适合的解决方案。

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus