Mybatis Plus分頁失效問題及解決方案

一、分頁失效的原因

Mybatis Plus是一款優秀的ORM框架，使用簡單方便。但是，在使用它進行分頁時，有時會出現分頁失效的問題，原因可能有以下幾個方面：

1、Mybatis Plus版本問題。如果使用的是較舊的版本，可能存在分頁失效的問題。解決辦法是升級到最新版本。

2、Mapper.xml文件中SQL語句格式問題。在Mapper.xml中書寫SQL語句時，如果格式不正確，可能會導致分頁失效。正確的格式是在最後加上limit #{offset}, #{pageSize}，其中#{offset}表示偏移量，#{pageSize}表示每頁顯示的數量。

3、Mybatis Plus默認分頁插件問題。默認情況下，Mybatis Plus自帶了一個分頁插件com.baomidou.mybatisplus.plugins.PaginationInterceptor。但是，有時候在進行複雜查詢時，這個分頁插件可能會失效，導致分頁查詢不到數據。

4、分頁參數傳參問題。如果使用的是分頁查詢方法，那麼在調用方法時必須傳入Page對象，而且必須在此前調用setRecordsTotal方法設置總記錄數。如果不設置總記錄數，則分頁插件無法工作，導致分頁查詢不到數據。

二、解決方案

針對上述幾個原因，我們可以有不同的解決方案：

1、升級Mybatis Plus版本

如果使用的是較舊版本的Mybatis Plus，可以嘗試升級到最新版本。最新版本已經解決了一些已知的分頁失效問題，可以提高分頁查詢的成功率。

// Maven中使用最新版本的Mybatis Plus

   com.baomidou
   mybatis-plus-boot-starter
   3.4.2

2、Mybatis Plus分頁插件配置

修改Mapper.xml文件，格式按照以下方式書寫：

<select id="selectPage" resultMap="BaseResultMap">
    select * from tb_demo
    <where>
        1 = 1
    </where>
    limit #{offset}, #{pageSize}
</select>

配置Mybatis Plus分頁插件，可以在application.yml文件中加入如下配置：

mybatis-plus:
  configuration:
    # 分頁插件，一般不需要修改
    page-params: pageNum=1;pageSize=10;count=countSql

3、自定義分頁插件

Mybatis Plus提供了自定義分頁插件的功能，可以根據業務進行自定義。自定義分頁插件需要繼承com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor類，然後實現intercept方法，在該方法中處理分頁邏輯。例如，自定義分頁插件可以根據前端傳入的分頁參數進行分頁，而不是使用默認的分頁參數。自定義分頁插件代碼示例如下：

public class CustomPaginationInterceptor extends PaginationInterceptor {

    @Override
    public Page SqlParserInterceptor(MappedStatement ms, Page page) {
        // 獲取前端傳入的分頁參數
        Integer pageNum = (Integer) page.get("pageNum");
        Integer pageSize = (Integer) page.get("pageSize");
        // 處理分頁邏輯
        int offset = (pageNum - 1) * pageSize;
        return super.SqlParserInterceptor(ms, new Page(offset, pageSize));
    }
}

4、正確傳參

如果在調用分頁查詢方法時不傳入Page對象或者沒有調用setRecordsTotal方法設置總記錄數，則分頁查詢不到數據。可以採用以下方式正確傳參：

// 分頁查詢方法
IPage<Demo> pageDemo = new Page<>(pageNum, pageSize);
// 設置總記錄數
pageDemo.setRecordsTotal(demoMapper.selectCount(null));
// 查詢
IPage<Demo> pageResult = demoMapper.selectPage(pageDemo, null);

三、總結

Mybatis Plus是一款非常好用的ORM框架，但是在使用分頁功能時可能會遇到分頁失效的問題。針對該問題，我們可以從Mybatis Plus版本、Mapper.xml文件格式、分頁插件、分頁參數傳參等方面入手，採取不同的解決方案。在進行分頁查詢時，建議使用最新版本的Mybatis Plus，並根據業務情況選擇合適的分頁插件。