快捷導(dǎo)航

pageHelper分頁(yè)失效問(wèn)題及解決方案

更新時(shí)間：2025年01月16日 09:24:03 作者：菜鳥(niǎo)阿都

文章介紹了Mybatis分頁(yè)插件pageHelper的一個(gè)bug,即在一對(duì)多查詢(xún)時(shí)會(huì)出現(xiàn)分頁(yè)錯(cuò)誤,作者提供了解決方案,包括方案一、方案二和方案三,方案一通過(guò)在服務(wù)層進(jìn)行額外查詢(xún)來(lái)解決分頁(yè)問(wèn)題,方案二利用mybatis的嵌套子查詢(xún)來(lái)解決,但可能產(chǎn)生'1+N'問(wèn)題

前言

pageHelper是一款優(yōu)秀的Mybatis分頁(yè)插件，在項(xiàng)目中可以非常便利的使用，使開(kāi)發(fā)效率得到很大的提升，但不支持一對(duì)多結(jié)果映射的分頁(yè)查詢(xún)，所以在平時(shí)的使用時(shí)，對(duì)于一對(duì)多分頁(yè)會(huì)出現(xiàn)分頁(yè)錯(cuò)誤，這篇文章主要對(duì)pageHelper分頁(yè)錯(cuò)誤進(jìn)行重現(xiàn)以及提出解決方案。

分析

mybatis進(jìn)行一對(duì)多查詢(xún)時(shí)，映射文件（mapper.xml)中的sql語(yǔ)句中使用的左連接，pageHelper會(huì)自動(dòng)對(duì)這條左連接sql語(yǔ)句進(jìn)行select count（0）的處理，并把結(jié)果作為分頁(yè)結(jié)構(gòu)的記錄總數(shù)，然后自動(dòng)將limit拼接到sql語(yǔ)句末尾進(jìn)行分頁(yè)，由于左連接查詢(xún)時(shí)，連接條件on條件不唯一（即一對(duì)多）時(shí)，結(jié)果會(huì)產(chǎn)生笛卡爾積，所以經(jīng)過(guò)pagehelper插件分頁(yè)得到的記錄總數(shù)和分頁(yè)結(jié)果并不是預(yù)期的結(jié)果。

數(shù)據(jù)準(zhǔn)備

共兩個(gè)表：user、address,用戶(hù)id與收貨地址表中userId對(duì)應(yīng)。

用戶(hù)表【user】：11條數(shù)據(jù)

收貨地址信息表【address】：4條數(shù)據(jù)

數(shù)據(jù)結(jié)構(gòu)

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

預(yù)期結(jié)果

要求對(duì)數(shù)據(jù)進(jìn)行分頁(yè)（每頁(yè)5條），獲得用戶(hù)信息，每個(gè)用戶(hù)信息帶出對(duì)應(yīng)收貨信息，用戶(hù)id為2和3的用戶(hù)各有兩條收貨地址信息，其余沒(méi)有。

期望結(jié)果如下

{
  "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": "錢(qián)六",
        "addressList": []
      },
      {
        "id": 5,
        "name": "劉七",
        "addressList": []
      }
    ]
  }
}

問(wèn)題重現(xiàn)

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進(jìn)行分頁(yè)，并輸出日志

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行：進(jìn)行數(shù)據(jù)總數(shù)的查詢(xún)，作為數(shù)據(jù)的總條數(shù)total

第2-4行：進(jìn)行分頁(yè)結(jié)果的查詢(xún)，查詢(xún)出5條數(shù)據(jù)

從日志中可以看出：

1. pageHelper插件拼接后的sql語(yǔ)句就不會(huì)輸出正確的結(jié)果，更不會(huì)輸出符合期望的結(jié)果

2. pageHelper插件分兩步查詢(xún)，第一步查詢(xún)出記錄總數(shù)，第二步查詢(xún)出分頁(yè)結(jié)果

解決方案

方案一

思路：先分頁(yè)查詢(xún)出user表數(shù)據(jù)，然后在serviec服務(wù)層根據(jù)用戶(hù)id查詢(xún)對(duì)應(yīng)的收貨地址信息，并關(guān)聯(lián)用戶(hù)信息與收貨信息。

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的嵌套子查詢(xún)

<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>
<!-- 主查詢(xún) -->
<select id="findAll" resultMap="getList">
    select * from user
</select>
<!-- 子查詢(xún) -->
<select id="getValueById" resultType="Address" >
    select a.* from address a where a.userId=#{userId}
</select>

與嵌套映射結(jié)構(gòu)的resultMap格式基本一致，一對(duì)多查詢(xún)采用的依舊是collection，區(qū)別在于collection中多了select與column屬性，select用于加載子查詢(xún)映射語(yǔ)句的id，它會(huì)從column屬性指定的列中檢索數(shù)據(jù)，作為參數(shù)傳遞給目標(biāo)select語(yǔ)句即子查詢(xún)。

缺點(diǎn)：這種方式雖然可以解決pagehelper一對(duì)多分頁(yè)的問(wèn)題，但在大型數(shù)據(jù)表與數(shù)據(jù)集上性能表現(xiàn)不佳，即產(chǎn)生'1+N'問(wèn)題。

輸出以下sql日志：首先通過(guò)主查詢(xún)語(yǔ)句獲得主表的數(shù)據(jù)總量作為分頁(yè)的total，第二步通過(guò)limit獲得前5條分頁(yè)數(shù)據(jù)（就是‘1’），第三步將第二步獲得結(jié)果作為參數(shù)通過(guò)子查詢(xún)獲得地址表的信息（就是‘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插件，自定義分頁(yè)查詢(xún)，先對(duì)主表（user）進(jìn)行分頁(yè)，并把分頁(yè)結(jié)果作為虛擬表與副表（address）進(jìn)行左連接查詢(xún)

<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>