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

背景介绍

在最近的一个项目中,我们决定将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版本之间产生冲突。

xml 复制代码
<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的地方都使用相同版本的库,从而避免潜在的兼容性问题。

xml 复制代码
<dependency>
    <groupId>com.github.jsqlparser</groupId>
    <artifactId>jsqlparser</artifactId>
    <version>4.7</version>
</dependency>
注意事项

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

相关推荐
兴趣互联7 小时前
jeecgboot nacos2.3.2 使用pgsql
java
hudd6688 小时前
JavaEE 初阶 - 文件操作和IO
java·开发语言·java-ee
Flynn Liang9 小时前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化
学长毕设9 小时前
基于SpringBoot社区快递驿站物流配送系统-附源码
java·spring boot·后端
Flynt9 小时前
Java4Shell 实测:EPYC 一跑就中招,关掉 Base64 硬件加速,1KB 解码慢 14 倍
java·安全·性能优化
Resean02239 小时前
Spring 源码分析(七)AOP 原理(上):代理的创建
java·后端·spring
Tangq一定可以的10 小时前
Spring AI Advisor 详解 - 给大模型调用加上“切面“,日志/过滤/记忆一键搞定
java·后端·spring
小巫编程室10 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
深入云栈11 小时前
Netty 4.2.x 源码深度解析 (二十四):池化内存分配 —— PoolArena、PoolChunk 与 PoolSubpage
java·后端·架构
惜.己12 小时前
Java结合idea简单使用Playwright
java·开发语言·自动化