Pagehelper分页插件返回分页total不符预期的问题

当使用PageHelper进行分页时，如果将分页返回的数据直接组装成PageInfo对象返回，可能会导致total数据对不上，导致分页接口异常。

下面情况就会出现total数据不符合预期的问题，每次total只会和userVolist的size相等。

public OperationInfo<PageInfo<UserVo>> detail(@RequestParam(required = false, defaultValue = "1") Integer pageNum,
                                              @RequestParam(required = false, defaultValue = "10") Integer pageSize) {
    //1、开始分页
    PageHelper.startPage(pageNum, pageSize);
    //2、紧接startPage，查询数据库
    List<User> userList = userDao.findPageList();
    //3、将查到的数据进行二次组装，User对象转换成UserVo
    List<UserVo> userVolist = convertUser2UserVo()
    //4、返回分页结果
    return OperationInfo.success("成功", PageInfo.of(userVolist));
}

原因

产生原因主要在于：

1. 步骤2中，返回的List被包装成了 Page对象， Page对象继承ArrayList，额外多了total等属性。就是分页插件代理sql后的分页结果

2. 步骤3中，此时把List数据，其实是带有total等分页属性的page实例当成List遍历转换成了另一个List，这个时候分页属性total等就丢掉了，而且可知，如果直接把第二部返回的List对象当作PageInfo的实例化参数，此时是可以符合预期的。

3. 步骤4中，PageInfo对象的实例化会判断userVolist，从userVolist中获取total等分页数据。PageInfo继承PageSerializable

   public PageInfo(List<T> list, int navigatePages) {
           super(list);//PageSerializable的实例化逻辑
           if (list instanceof Page) {
               // 当入参是分页page就会以分页page的参数来实例化，此时是符合预期的
               Page page = (Page) list;
               this.pageNum = page.getPageNum();
               this.pageSize = page.getPageSize();
   
               this.pages = page.getPages();
               this.size = page.size();
               //由于结果是>startRow的，所以实际的需要+1
               if (this.size == 0) {
                   this.startRow = 0;
                   this.endRow = 0;
               } else {
                   this.startRow = page.getStartRow() + 1;
                   //计算实际的endRow（最后一页的时候特殊）
                   this.endRow = this.startRow - 1 + this.size;
               }
           } else if (list instanceof Collection) {
               // 当是转换后的list，此时就会是根据list的size来进行计算分页参数就出现这个不符合预期的结果
               this.pageNum = 1;
               this.pageSize = list.size();
   
               this.pages = this.pageSize > 0 ? 1 : 0;
               this.size = list.size();
               this.startRow = 0;
               this.endRow = list.size() > 0 ? list.size() - 1 : 0;
           }
           if (list instanceof Collection) {
               calcByNavigatePages(navigatePages);
           }
       }
   

   super(list)逻辑

   当PageInfo实例入参时是Page对象就会去Page对象的total、如果是List就直接取size了。

   public PageSerializable(List<T> list) {
       this.list = list;
       if(list instanceof Page){
           this.total = ((Page)list).getTotal();
       } else {
           this.total = list.size();
       }
   }
   

解决方案

在转换数据时，将原有的分页对象获取到，将分页参数进行转存，最后设置转换后的list即可。

public OperationInfo<PageInfo<UserVo>> detail(@RequestParam(required = false, defaultValue = "1") Integer pageNum,
                                              @RequestParam(required = false, defaultValue = "10") Integer pageSize) {
    //1、开始分页、暂存分页参数
    Page<UserVo> page = PageHelper.startPage(pageNum, pageSize);
    //2、紧接startPage，查询数据库
    List<User> userList = userDao.findPageList();
    //3、将查到的数据进行二次组装，User对象转换成UserVo
    List<UserVo> userVolist = convertUser2UserVo();
    //4、组装分页参数
    PageInfo<UserVo> pageInfo = PageInfo.of(page);
    //5、设置结果列表
    pageInfo.setList(userVolist)
    return OperationInfo.success("成功", pageInfo);
}