SpringBoot+MyBatis分页失效问题解决（已解决）

最新推荐文章于 2025-11-16 23:33:04 发布

原创最新推荐文章于 2025-11-16 23:33:04 发布 · 2.2k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #java

本文围绕SpringBoot项目中使用PageHelper实现分页展开。作者采用pagehelper - spring - boot - starter方式，却遇到分页不生效、总返回全量数据的问题。经查看官网文档，发现是PageHelper方法与MyBatis查询方法调用顺序有误，导致分页参数提前被消费。

官方文档：pagehelper
SpringBoot项目，直接导入 pagehelper-spring-boot-starter

<dependency>
     <groupId>com.github.pagehelper</groupId>
     <artifactId>pagehelper-spring-boot-starter</artifactId>
     <version>1.2.5</version>
</dependency>

SpringBoot的自动配置都帮我们实现配置了可以不需要上面的配置，因为SpringBoot很多配置采用了默认机制，我是使用 pagehelper-spring-boot-starter 方式的，发现分页总是返回所有的数据total，但是分页就是不生效,每次都会查出全量数据，因为配置文件都配置好没有错，那肯定是代码出错，当我查看官网文档的时候，发现官网的介绍分页失效的原因：

什么时候会导致不安全的分页？
PageHelper 方法使用了静态的 ThreadLocal 参数，分页参数和线程是绑定的。
只要你可以保证在 PageHelper 方法调用后紧跟 MyBatis 查询方法，这就是安全的。
因为 PageHelper 在 finally 代码段中自动清除了 ThreadLocal 存储的对象。
如果代码在进入 Executor 前发生异常，就会导致线程不可用，这属于人为的 Bug
（例如接口方法和 XML 中的不匹配，导致找不到 MappedStatement 时），这种情况由于线程不可用，也不会导致 ThreadLocal 参数被错误的使用。

错误代码：

public PageInfo<T> get88( int pageNum, int pageSize) {
        PageHelper.startPage(pageNum,pageSize);
        String district = areaMapper.selectAreaNameByCode(districtCode);
        List<Home> homeList = homeMapper.selectAllHomeByFeatureIdDistrict(featureId, district);
        PageInfo<Home> pageResult = new PageInfo<>(homeList);
        return ServerResponse.createBySuccess(pageResult);
    }

看了我的代码，顿时醒悟，PageHelper.startPage(pageNum,pageSize); 后面接的方法是areaMapper.selectAreaNameByCode(); 而我需要分页的方法是下面selectAllHomeByFeatureIdDistrict()方法，所有PageHelper.startPage被提前消费使用了，只需要交代码改为：


public PageInfo<T> get88( int pageNum, int pageSize) {
       String district = areaMapper.selectAreaNameByCode(districtCode); 
       //记住：PageHelper.startPage要紧跟着要分页的方法
       PageHelper.startPage(pageNum,pageSize);
       List<Home> homeList = homeMapper.selectAllHomeByFeatureIdDistrict(featureId, district);
       PageInfo<Home> pageResult = new PageInfo<>(homeList);
       return ServerResponse.createBySuccess(pageResult);
   }