前言

pageHelper是一款优秀的Mybatis分页插件，在项目中可以非常便利的使用，使开发效率得到很大的提升，但不支持一对多结果映射的分页查询，所以在平时的使用时，对于一对多分页会出现分页错误，这篇文章主要对pageHelper分页错误进行重现以及提出解决方案。

分析

mybatis进行一对多查询时，映射文件（mapper.xml)中的sql语句中使用的左连接，pageHelper会自动对这条左连接sql语句进行select count（0）的处理，并把结果作为分页结构的记录总数，然后自动将limit拼接到sql语句末尾进行分页，由于左连接查询时，连接条件on条件不唯一（即一对多）时，结果会产生笛卡尔积，所以经过pagehelper插件分页得到的记录总数和分页结果并不是预期的结果。

数据准备

共两个表：user、address,用户id与收货地址表中userId对应。

用户表【user】:11条数据

pageHelper分页失效解决方案前言分析数据准备数据结构预期结果问题重现解决方案

收货地址信息表【address】：4条数据

数据结构

public class UserDto {
    public int id;
    public String name;
    List<Address> addressList;
}

复制

预期结果

要求对数据进行分页（每页5条），获得用户信息，每个用户信息带出对应收货信息，用户id为2和3的用户各有两条收货地址信息，其余没有。期望结果如下

{
  "code": 200,
  "message": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 5,
    "pages": 3,
    "size": 5,
    "total": 11,
    "data": [
      {
        "id": 1,
        "name": "张三",
        "addressList": []
      },
      {
        "id": 2,
        "name": "李四",
        "addressList": [
          {
            "id": 1,
            "address": "陕西省宝鸡市",
            "userId": 2
          },
          {
            "id": 2,
            "address": "陕西省延安市",
            "userId": 2
          }
        ]
      },
      {
        "id": 3,
        "name": "王五",
        "addressList": [
          {
            "id": 3,
            "address": "陕西省西安市",
            "userId": 3
          },
          {
            "id": 4,
            "address": "陕西省汉中市",
            "userId": 3
          }
        ]
      },
      {
        "id": 4,
        "name": "钱六",
        "addressList": []
      },
      {
        "id": 5,
        "name": "刘七",
        "addressList": []
      }
    ]
  }
}

复制

问题重现

mybatis映射文件

<resultMap id="list" type="UserDto">
    <id property="id" column="id" />
    <result property="name" column="name"/>
    <collection property="addressList" ofType="Address">
        <result property="address" column="address"/>
        <result property="userId" column="userId"/>
    </collection>
</resultMap>
 
<select id="findAll"  resultMap="list" >
    SELECT
    a.*,b.address,b.userId
    FROM user a
    LEFT JOIN address b on a.id=b.userId
</select>

复制

然后我们使用pageHelper进行分页，并输出日志

SELECT count(0) FROM user a LEFT JOIN address b ON a.id = b.userId
Preparing: SELECT a.*,b.address,b.userId FROM user a LEFT JOIN address b on a.id=b.userId LIMIT ?
Parameters: 5(Integer)
Total: 5

复制

日志分析

第1行：进行数据总数的查询，作为数据的总条数total

第2-4行：进行分页结果的查询，查询出5条数据

从日志中可以看出

1. pageHelper插件拼接后的sql语句就不会输出正确的结果，更不会输出符合期望的结果

2. pageHelper插件分两步查询，第一步查询出记录总数，第二步查询出分页结果

解决方案

方案一

思路：先分页查询出user表数据，然后在serviec服务层根据用户id查询对应的收货地址信息，并关联用户信息与收货信息。

service文件

public List<UserDto> findAll(){
    List<UserDto> userList=userMapper.findUser();
    userList.forEach((item)-> {
    item.setAddressList(userMapper.findByUserId(item.id));
    });
    return userList;
}

复制

mybatis映射文件

<select id="findUser" resultType="UserDto">
    SELECT * FROM user
</select>
<select id="findByUserId" parameterType="integer" resultType="Address">
    SELECT * FROM address where userId=#{userId}
</select>

复制

方案二

思路：使用mybatis的嵌套子查询

<resultMap id="getList" type="UserDto">
    <id property="id" column="id" />
    <result property="name" column="name"/>
    <collection property="addressList" ofType="Address" javaType="List" column="{userId=id}" select="getValueById" >
        <id property="id" column="id" />
        <result property="address" column="address"/>
        <result property="userId" column="userId"/>
    </collection>
</resultMap>
<!-- 主查询 -->
<select id="findAll" resultMap="getList">
    select * from user
</select>
<!-- 子查询 -->
<select id="getValueById" resultType="Address" >
    select a.* from address a where a.userId=#{userId}
</select>

复制

与嵌套映射结构的resultMap格式基本一致，一对多查询采用的依旧是collection，区别在于collection中多了select与column属性，select用于加载子查询映射语句的id，它会从column属性指定的列中检索数据，作为参数传递给目标select语句即子查询。

缺点：这种方式虽然可以解决pagehelper一对多分页的问题，但在大型数据表与数据集上性能表现不佳，即产生'1+N'问题。

输出以下sql日志：首先通过主查询语句获得主表的数据总量作为分页的total，第二步通过limit获得前5条分页数据（就是‘1’），第三步将第二步获得结果作为参数通过子查询获得地址表的信息（就是‘N’）

Preparing: SELECT count(0) FROM user
Parameters: 
Total: 1
Preparing: select * from user LIMIT ?
Parameters: 5(Integer)
Preparing: select a.* from address a where a.userId=?
Parameters: 1(Integer)
Total: 0
Preparing: select a.* from address a where a.userId=?
Parameters: 2(Integer)
Total: 2
Preparing: select a.* from address a where a.userId=?
Parameters: 3(Integer)
Total: 2
Preparing: select a.* from address a where a.userId=?
Parameters: 4(Integer)
Total: 0
Preparing: select a.* from address a where a.userId=?
Parameters: 5(Integer)
Total: 0

复制

方案三

思路：弃用pageHelper插件，自定义分页查询，先对主表（user）进行分页，并把分页结果作为虚拟表与副表（address）进行左连接查询

<resultMap id="list" type="UserDto">
        <id property="id" column="id" />
        <result property="name" column="name"/>
        <collection property="addressList" ofType="Address">
            <result property="address" column="address"/>
            <result property="userId" column="userId"/>
        </collection>
 </resultMap>
<select id="findAll" resultMap="list"  parameterType="integer">
    SELECT
        a.*,
        b.address,
        b.userId
    FROM
            ( SELECT * FROM user LIMIT #{size} ) a
                LEFT JOIN address b ON a.id = b.userid
</select>

复制

pageHelper分页失效解决方案前言分析数据准备数据结构预期结果问题重现解决方案

前言

分析

数据准备

数据结构

预期结果

问题重现

解决方案

方案一

方案二

方案三