MybatisPlus与PageHelper分页冲突的深度解析

分页插件在Java开发中非常常见，MybatisPlus和PageHelper都是广泛使用的分页工具。但在实际开发中，二者可能存在冲突，尤其是涉及jsqlparser、pagehelper和MybatisPlus的版本兼容性问题。

冲突现象分析

同时使用MybatisPlus和PageHelper时，可能会遇到分页失效、SQL解析错误或分页结果异常的问题。常见表现包括分页参数未生效、总记录数计算错误或SQL语法解析异常。

问题的根源在于二者都通过拦截器机制修改SQL语句，但实现方式不同，导致冲突。特别是当二者的jsqlparser版本不兼容时，SQL解析会出现问题。

关键组件版本兼容性

jsqlparser是SQL语句解析的核心库，PageHelper和MybatisPlus均依赖它。以下是常见的兼容版本组合：

• PageHelper 5.3.x：兼容jsqlparser 4.5及以上版本。
• MybatisPlus 3.4.x：建议使用jsqlparser 4.2或4.3版本。
• MybatisPlus 3.5.x：推荐jsqlparser 4.6版本。

版本不匹配可能导致SQL解析失败，如分页语法错误或嵌套查询解析异常。

解决方案

统一jsqlparser版本

确保项目中只存在一个兼容的jsqlparser版本。在Maven或Gradle中显式指定版本，并排除冲突的依赖：

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>5.3.2</version>
    <exclusions>
        <exclusion>
            <groupId>com.github.jsqlparser</groupId>
            <artifactId>jsqlparser</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3</version>
</dependency>

<dependency>
    <groupId>com.github.jsqlparser</groupId>
    <artifactId>jsqlparser</artifactId>
    <version>4.6</version>
</dependency>

禁用冲突的分页插件

如果仅需使用其中一个分页插件，可以通过配置禁用另一个插件：

• 禁用PageHelper：在配置文件中设置pagehelper.enable=false。
• 禁用MybatisPlus分页：避免使用PaginationInterceptor或MybatisPlusInterceptor的分页配置。

自定义分页逻辑

在需要同时使用的场景下，通过代码手动控制分页逻辑。例如，优先使用MybatisPlus的分页查询，再通过PageHelper调整结果：

Page<Object> page = new Page<>(current, size);
List<Object> records = mapper.selectPage(page, queryWrapper).getRecords();
// 手动计算总记录数
long total = page.getTotal();

最佳实践建议

• 优先使用MybatisPlus的内置分页功能，避免引入PageHelper。
• 定期检查依赖树，确保没有隐式的jsqlparser版本冲突。
• 在Spring Boot项目中，利用@ConditionalOnProperty动态启用分页插件。

通过合理管理版本和配置，可以高效解决MybatisPlus与PageHelper的分页冲突问题。