MyBatis-Plus与PageHelper的jsqlparser库冲突问题

news/2025/2/9 5:35:11 标签: mybatis, java

背景介绍

在最近的一个项目中，我们决定将Spring Boot升级至3.x版本，并同时升级了MyBatis-Plus到最新版本（3.5.7）。然而，在完成这些升级之后，我们遇到了一个问题：分页插件PageHelper无法正常工作。经过排查发现，这是因为MyBatis-Plus和PageHelper都依赖于jsqlparser库，但它们所依赖的版本存在冲突。

问题描述

我们的项目使用了以下依赖：

MyBatis-Plus: 版本3.5.7
PageHelper: 版本2.1.0

PageHelper要求使用的jsqlparser版本为4.7，而MyBatis-Plus可能引入了一个不同版本的jsqlparser。这种不一致导致了兼容性问题，使得PageHelper不能正确解析SQL语句，从而影响了其分页功能的正常使用。

冲突原因分析

由于两个库都依赖于jsqlparser，当两个库对jsqlparser的版本有不同的需求时，就会发生冲突。例如，PageHelper需要jsqlparser的特定版本来确保其解析SQL的能力，而MyBatis-Plus可能引入了一个更新或更旧版本的jsqlparser，这可能会破坏PageHelper的功能。

解决方案详解

为了确保项目的正常运行，我们需要手动解决这个依赖冲突。以下是详细的解决方案：

步骤一：排除冲突的jsqlparser依赖

在pom.xml文件中，针对MyBatis-Plus和PageHelper的依赖，分别排除其自带的jsqlparser依赖。这样做的目的是避免自动导入的jsqlparser版本之间产生冲突。

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.7</version>
    <exclusions>
        <exclusion>
            <groupId>com.github.jsqlparser</groupId>
            <artifactId>jsqlparser</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>2.1.0</version>
    <exclusions>
        <exclusion>
            <groupId>com.github.jsqlparser</groupId>
            <artifactId>jsqlparser</artifactId>
        </exclusion>
    </exclusions>
</dependency>

步骤二：添加指定版本的jsqlparser依赖

接下来，在pom.xml中明确添加jsqlparser 4.7版本的依赖。这样做是为了确保项目中所有依赖jsqlparser的地方都使用相同版本的库，从而避免潜在的兼容性问题。

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

注意事项

尽管通过上述步骤可以解决依赖冲突问题，但在实际开发过程中，还是建议尽量避免同时使用MyBatis-Plus和PageHelper。因为即使解决了当前的版本冲突问题，未来随着库的更新，可能会出现新的不兼容情况。此外，MyBatis-Plus自身也提供了分页插件，可以作为替代方案考虑。