国开机考网站界面设计免费自助建站模板

一、背景

在同时使用 MyBatis-Plus 的 IPage 分页 和 PageHelper 时，开发者可能会遇到以下两类问题：

• 分页结果异常：IPage 查询的 total 总条数返回 0，但实际数据正常。
• 依赖冲突报错：启动时报错 Column.withColumnName() 方法不存在，因 jsqlparser 版本不兼容。

二、分析

1、问题一：IPage 查询的 total 为 0

（1）原因：

• 拦截器冲突：PageHelper和MyBatis-Plus的分页拦截器均会修改SQL，导致分页逻辑被覆盖。

• 分页参数残留：PageHelper通过ThreadLocal保存分页参数，若未清除，会影响后续IPage查询。

（2）解决方案

• 统一分页工具：避免混用，统一使用MyBatis-Plus的IPage或PageHelper。
• 调整拦截器顺序：若需要都支持两种分页方式，则确保MyBatis-Plus的拦截器在PageHelper之后执行，避免SQL被错误改写，如下：

@SpringBootApplication(exclude = PageHelperAutoConfiguration.class) // 禁用PageHelper自动配置
public class Application { ... }

@Configuration
public class MyBatisConfig {// 先注册PageHelper拦截器@Beanpublic PageInterceptor pageInterceptor() {PageInterceptor pageInterceptor = new PageInterceptor();Properties props = new Properties();props.setProperty("helperDialect", "mysql");pageInterceptor.setProperties(props);return pageInterceptor;}// 后注册MyBatis-Plus拦截器@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));return interceptor;}
}

2、问题一：jsqlparser版本冲突报错

（1）报错信息如下：

Caused by: java.lang.NoSuchMethodError: 
net.sf.jsqlparser.schema.Column.withColumnName(Ljava/lang/String;)Lnet/sf/jsqlparser/schema/Column;

（2）原因：

  MyBatis-Plus的PaginationInnerInterceptor依赖jsqlparser 4.5+，而PageHelper可能引入旧版本（如3.2），导致方法缺失。

（3）解决方案

• 升级jsqlparser版本，并显式引入高版本jsqlparser（如4.6）
• 推荐 MyBatis-Plus 3.5.3+（兼容 jsqlparser 4.6）

<!-- 排除 PageHelper 中的旧版本 jsqlparser -->
<dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper-spring-boot-starter</artifactId><version>1.4.6</version><exclusions><exclusion><groupId>com.github.jsqlparser</groupId><artifactId>jsqlparser</artifactId></exclusion></exclusions>
</dependency><!-- 显式引入新版本 jsqlparser -->
<dependency><groupId>com.github.jsqlparser</groupId><artifactId>jsqlparser</artifactId><version>4.6</version>
</dependency><dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.5.3.1</version> <!-- 使用最新版本 -->
</dependency>