MybatisPlus和pagehelper分页冲突—关于jsqlparser、pagehelper、MybatisPlus三者的版本兼容问题

1 问题描述

今天在集成pagehelper依赖时，遇到问题，程序查询数据库时报错找不到jsqlparser类，下面是项目相关依赖：

XML 复制代码

    <properties>           
        <mybatis-plus.version>3.5.7</mybatis-plus.version>
        <pagehelper.boot.version>2.1.1</pagehelper.boot.version>
    </properties>

XML 复制代码

            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
                <version>${mybatis-plus.version}</version>
            </dependency>
            <dependency>
                <groupId>com.github.pagehelper</groupId>
                <artifactId>pagehelper-spring-boot-starter</artifactId>
                <version>${pagehelper.boot.version}</version>
            </dependency>

2 解决方法

2.1 问题原因

使用Maven Helper插件查看pom文件的依赖，发现依赖冲突：

pagehelper-spring-boot-starter依赖集成的jsqlparser是4.7版本（这也是目前pagehelper-spring-boot-starter最新版本2.1.1的支持依赖，截止2025-10-5）。

而mybatis-plus-spring-boot3-starter集成的jsqlparser是4.9版本，因此低版本无法向高版本兼容。

对于pagehelper-spring-boot-starter内部也集成了mybatis-plus-spring-boot-starter的依赖，但是版本较低：

2.2 解决方案

2.2.1 方案1

放弃使用pagehelper，mybatisplus的分页功能也很强大，直接使用mybatisplus即可。

2.2.2 方案2

在发生依赖冲突的地方，右键，选择Exclude排除冲突依赖：

只能通过这种方式排除pagehelper-spring-boot-starter依赖集成的mybatis-plus依赖与项目中集成的mybatis-plus依赖版本兼容冲突。

由于pagehelper-spring-boot-starter依赖目前最高只支持4.7版本的jsqlparser，因此不能只排除pagehelper-spring-boot-starter依赖的jsqlparser冲突，同时需要排除mybatis-plus依赖的jsqlparser冲突：

XML 复制代码

            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
                <version>${mybatis-plus.version}</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>${pagehelper.boot.version}</version>
                <exclusions>
                    <exclusion>
                        <groupId>com.github.jsqlparser</groupId>
                        <artifactId>jsqlparser</artifactId>
                    </exclusion>
                    <exclusion>
                        <artifactId>mybatis</artifactId>
                        <groupId>org.mybatis</groupId>
                    </exclusion>
                    <exclusion>
                        <artifactId>mybatis-spring</artifactId>
                        <groupId>org.mybatis</groupId>
                    </exclusion>
                </exclusions>
            </dependency>

            <!-- 此处需要指定jsqlparser版本为4.7，防止pagehelper集成的jsqlparser版本与mybatisplus集成的jsqlparser版本冲突 -->
            <dependency>
                <groupId>com.github.jsqlparser</groupId>
                <artifactId>jsqlparser</artifactId>
                <version>${jsqlparser.version}</version>
            </dependency>

XML 复制代码

    <properties>           
        <jsqlparser.version>4.7</jsqlparser.version>
        <mybatis-plus.version>3.5.7</mybatis-plus.version>
        <pagehelper.boot.version>2.1.1</pagehelper.boot.version>
    </properties>

2.2.3 方案3

不使用pagehelper-spring-boot-starter依赖，直接使用pagehelper依赖，排除mybatis-plus集成的jsqlparser，并引入jsqlparser依赖与mybatis-plus、pagehelper兼容的版本：

XML 复制代码

            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
                <version>${mybatis-plus.version}</version>
                <exclusions>
                    <exclusion>
                        <groupId>com.github.jsqlparser</groupId>
                        <artifactId>jsqlparser</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
            <dependency>
                <groupId>com.github.pagehelper</groupId>
                <artifactId>pagehelper</artifactId>
                <version>${pagehelper.version}</version>
            </dependency>
            <!-- 此处需要指定jsqlparser版本为4.7，防止pagehelper集成的jsqlparser版本与mybatisplus集成的jsqlparser版本冲突 -->
            <dependency>
                <groupId>com.github.jsqlparser</groupId>
                <artifactId>jsqlparser</artifactId>
                <version>${jsqlparser.version}</version>
            </dependency>

XML 复制代码

    <properties>           
        <jsqlparser.version>4.7</jsqlparser.version>
        <mybatis-plus.version>3.5.7</mybatis-plus.version>
        <pagehelper.version>6.1.1</pagehelper.version>
    </properties>