当前位置：首页 > news >正文

SB4 + MyBatis Plus 3.5.15，加入依赖以后，获取列表，分页返回的total=0的解决

news 2026/3/26 20:56:35

1、total=0原因

升级了系统以后，发现列表出来的结果total=0，但是单页的数据=1，其根本原因还是因为没有配制参数。

2、代码

@GetMapping("/list") public Result<Page<Table>> list( @RequestParam(defaultValue = "1") Long pageNum, // 推荐Long类型适配分页插件 @RequestParam(defaultValue = "10") Long pageSize, @RequestParam(required = false) String tableName ) { // 1. 初始化分页对象 Page<Table> page = new Page<>(pageNum, pageSize); // 2. 构建查询条件Wrapper（核心：只构建一次，无冗余） LambdaQueryWrapper<Table> wrapper = new LambdaQueryWrapper<Table>() .eq(Table::getSoftDel, 0) // 过滤已删除数据 .like(StringUtils.hasText(tableName), Table::getTableName, tableName) // 表名模糊查询（非空才生效） .orderByDesc(Table::getCreateTime); // 按创建时间降序排序 // 3. 执行分页查询（直接传入page和wrapper） Page<Table> tablePage = tableService.page(page, wrapper); // 4. 调试日志（可选，便于排查total=0问题） log.info("表列表分页查询结果：总条数={}, 当前页数据量={}, 查询条件：表名={}", tablePage.getTotal(), tablePage.getRecords().size(), tableName); // 5. 返回统一结果 return Result.success(tablePage); }

3、增加分页配制解决

@Configuration public class MybatisPlusConfig { /** * 分页插件（Spring Boot 4.x 唯一正确配置方式） */ @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { // 1. 创建 MyBatis-Plus 拦截器链（Spring Boot 4.x 必须用这个类） MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // 2. 初始化分页插件（Spring Boot 4.x 兼容版本） PaginationInnerInterceptor paginationInterceptor = new PaginationInnerInterceptor(DbType.MYSQL); // 3. Spring Boot 4.x 推荐配置（防止分页异常） paginationInterceptor.setOverflow(true); // 页码溢出自动处理 paginationInterceptor.setMaxLimit(1000L); // 单页最大条数限制 // 4. 将分页插件添加到拦截器链（核心步骤，否则插件不生效） interceptor.addInnerInterceptor(paginationInterceptor); return interceptor; } }

4、解决过程

PaginationInnerInterceptor依赖mybatis-plus-jsqlparser这个包（用于 SQL 解析，MyBatis-Plus 分页插件的核心依赖），缺失该依赖会直接导致类找不到。

一、完整的 Maven 依赖配置（Spring Boot 4.0.2 适配版）

在pom.xml中补充mybatis-plus-jsqlparser，并统一版本：

<!-- 统一 MyBatis-Plus 版本 --> <properties> <mybatis-plus.version>3.5.15</mybatis-plus.version> </properties> <!-- MyBatis-Plus 核心依赖（Spring Boot 4.x 适配） --> <dependencies> <!-- Spring Boot 4.x 专属 starter --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-spring-boot4-starter</artifactId> <version>${mybatis-plus.version}</version> </dependency> <!-- 分页插件核心依赖（必须加！解决 PaginationInnerInterceptor 找不到） --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-jsqlparser</artifactId> <version>${mybatis-plus.version}</version> </dependency> <!-- MySQL 驱动（Spring Boot 4.x 适配） --> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency> </dependencies>

关键说明：

mybatis-plus-jsqlparser：分页插件的 SQL 解析核心，缺失必报类找不到错误；
所有 MyBatis-Plus 相关依赖版本必须统一（均为 3.5.15），避免版本冲突。

二、最终版分页插件配置类

package com.czycg.mro.system.config; import com.baomidou.mybatisplus.annotation.DbType; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; /** * Spring Boot 4.0.2 + MyBatis-Plus 3.5.15 分页插件最终配置 * 依赖：mybatis-plus-jsqlparser + mybatis-plus-extension */ @Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // 分页插件（现在能正常识别，无报错） PaginationInnerInterceptor paginationInterceptor = new PaginationInnerInterceptor(DbType.MYSQL); paginationInterceptor.setOverflow(true); // 页码溢出自动处理 paginationInterceptor.setMaxLimit(1000L); // 单页最大条数限制 interceptor.addInnerInterceptor(paginationInterceptor); return interceptor; } }

三、最终版分页查询接口（total 正常返回）

@GetMapping("/list") public Result<Page<Table>> list( @RequestParam(defaultValue = "1") Long pageNum, @RequestParam(defaultValue = "10") Long pageSize, @RequestParam(required = false) String tableName ) { Page<Table> page = new Page<>(pageNum, pageSize); LambdaQueryWrapper<Table> wrapper = new LambdaQueryWrapper<Table>() .eq(Table::getSoftDel, 0) .like(StringUtils.hasText(tableName), Table::getTableName, tableName) .orderByDesc(Table::getCreateTime); // 分页插件生效，自动执行 COUNT 统计 Page<Table> tablePage = tableService.page(page, wrapper); log.info("分页查询结果：总条数={}, 当前页数据量={}", tablePage.getTotal(), tablePage.getRecords().size()); return Result.success(tablePage); }

四、最后一步：强制更新依赖（确保生效）

执行以下 Maven 命令，清理缓存并重新下载依赖：

# 终端执行 mvn clean install -U

-U：强制更新快照 / 依赖，确保mybatis-plus-jsqlparser被正确下载；
执行完成后，重启 IDE 并重新导入项目。

总结（核心解决要点）

缺失依赖：补充mybatis-plus-jsqlparser（分页插件 SQL 解析核心）；
版本统一：所有 MyBatis-Plus 依赖版本均为 3.5.15，避免冲突；
配置正确：分页插件通过MybatisPlusInterceptor装载，包名带连字符；
最终效果：
- IDE 不再提示PaginationInnerInterceptor找不到；
- 分页接口自动执行COUNT(*)统计，total显示真实总数；
- records显示当前页数据，分页功能完全正常。

现在配置完成后，你的 Spring Boot 4.0.2｜3 项目就能完美运行分页功能，所有报错都会消失。

根据原因

在 MyBatis-Plus 3.5.x（特别是 3.5.5+ 及 3.5.15 版本）中，分页插件的核心依赖mybatis-plus-jsqlparser被剥离成了独立模块，不再默认包含在mybatis-plus-extension或starter的传递依赖中（或者在某些 Spring Boot 4 的特定打包策略下未被自动引入）。

PaginationInnerInterceptor底层强依赖JSqlParser来解析和改写 SQL。如果缺少mybatis-plus-jsqlparser依赖，编译器不仅可能找不到相关的解析类，甚至在某些构建配置下会导致PaginationInnerInterceptor类本身无法被正确加载或识别（因为类加载器校验依赖失败）。

查看全文

http://www.jsqmd.com/news/419566/