1. 问题背景与冲突现象在Java持久层开发中MyBatis-Plus和PageHelper都是高频使用的工具库。MyBatis-Plus自带的分页插件PaginationInnerInterceptor通过动态改写SQL实现物理分页而PageHelper则通过拦截器机制实现逻辑分页。当两者同时存在于项目中时开发者经常会遇到以下典型报错Caused by: java.lang.NoSuchMethodError: net.sf.jsqlparser.statement.select.PlainSelect.getSelectItems()Ljava/util/List;这个错误的本质是两者依赖的jsqlparser版本不兼容。jsqlparser是一个SQL语句解析器MyBatis-Plus 3.x版本默认依赖jsqlparser 4.0版本而PageHelper 5.x版本要求jsqlparser 3.2版本。当Maven依赖传递导致版本冲突时就会抛出上述方法找不到的异常。2. 依赖冲突的根因分析2.1 技术栈依赖关系图MyBatis-Plus 3.5.3 └── jsqlparser 4.5 PageHelper 5.3.2 └── jsqlparser 3.22.2 版本不兼容的具体表现两个库对jsqlparser的依赖差异主要体现在API变更jsqlparser 4.0对SelectItem相关接口做了重构移除了getSelectItems()方法包路径变化3.x版本使用com.github.jsqlparser4.x改为net.sf.jsqlparser语法解析逻辑分页语句的解析方式在4.x版本有重大调整3. 解决方案设计与验证3.1 方案一统一使用MyBatis-Plus分页推荐!-- 移除PageHelper依赖 -- dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper/artifactId version5.3.2/version exclusions exclusion groupIdcom.github.jsqlparser/groupId artifactIdjsqlparser/artifactId /exclusion /exclusions /dependency !-- 确保使用MP默认的jsqlparser -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency配置MyBatis-Plus分页拦截器Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }3.2 方案二强制指定jsqlparser版本properties jsqlparser.version3.2/jsqlparser.version /properties dependencies dependency groupIdcom.github.jsqlparser/groupId artifactIdjsqlparser/artifactId version${jsqlparser.version}/version /dependency dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper/artifactId version5.3.2/version /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version exclusions exclusion groupIdnet.sf.jsqlparser/groupId artifactIdjsqlparser/artifactId /exclusion /exclusions /dependency /dependencies注意此方案可能导致MyBatis-Plus部分SQL解析功能异常4. 混合使用场景的特殊处理4.1 分页插件执行顺序控制当必须同时使用两个分页插件时需要通过Order注解明确指定拦截器顺序Configuration public class PageConfig { Bean Order(0) public PageInterceptor pageInterceptor() { return new PageInterceptor(); } Bean Order(1) public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); return interceptor; } }4.2 动态切换分页策略通过ThreadLocal实现运行时分页策略切换public class PageContext { private static final ThreadLocalBoolean MP_PAGE ThreadLocal.withInitial(() - false); public static void useMpPage() { MP_PAGE.set(true); } public static boolean isMpPage() { return MP_PAGE.get(); } } // 在Service层按需切换 public PageResultUser listUsers(PageParam param) { try { PageContext.useMpPage(); PageUser page new Page(param.getPageNum(), param.getPageSize()); return userMapper.selectPage(page, null); } finally { PageContext.remove(); } }5. 生产环境验证要点5.1 兼容性测试清单基础分页功能测试正常页码请求超出范围的页码处理pageSize边界值验证复杂SQL场景验证多表联查分页包含子查询的分页带有聚合函数的分页性能压测指标10万级数据量分页响应时间高并发下的稳定性内存占用监控5.2 常见故障排查指南现象可能原因解决方案分页总数不准1. 子查询未正确处理2. 关联查询重复计数1. 使用SqlParser注解过滤2. 自定义count查询排序失效1. 多个拦截器顺序冲突2. SQL注入过滤1. 调整拦截器顺序2. 检查安全策略配置内存泄漏1. PageHelper未调用clearPage2. 大结果集未流式处理1. 添加finally清理2. 使用游标查询6. 进阶优化方案6.1 自定义分页拦截器继承PaginationInnerInterceptor实现方言扩展public class CustomPaginationInterceptor extends PaginationInnerInterceptor { Override protected void handlerDialect(MetaObject metaObject, String sql) { if (isOracle()) { // 处理Oracle特殊分页语法 String newSql SELECT * FROM ( SELECT ROW_.*, ROWNUM ROWNUM_ FROM ( sql ) ROW_ WHERE ROWNUM ?) WHERE ROWNUM_ ?; metaObject.setValue(sql, newSql); } else { super.handlerDialect(metaObject, sql); } } }6.2 性能优化技巧Count查询优化Select(SELECT COUNT(1) FROM user WHERE status #{status}) long countByStatus(Param(status) int status);延迟关联策略-- 先获取id集合 SELECT id FROM table WHERE conditions LIMIT ?,? -- 再通过IN查询获取完整数据 SELECT * FROM table WHERE id IN (ids)游标分页实现try (CursorUser cursor userMapper.scan(limit)) { cursor.forEach(user - process(user)); }在实际项目中使用混合分页方案时建议建立严格的code review机制。我们团队通过Git预提交钩子强制检查分页相关的依赖声明确保不会出现版本冲突。对于核心业务的分页查询建议在单元测试中加入SQL解析验证环节使用Mockito模拟不同jsqlparser版本的行为差异
解决MyBatis-Plus与PageHelper的jsqlparser版本冲突
1. 问题背景与冲突现象在Java持久层开发中MyBatis-Plus和PageHelper都是高频使用的工具库。MyBatis-Plus自带的分页插件PaginationInnerInterceptor通过动态改写SQL实现物理分页而PageHelper则通过拦截器机制实现逻辑分页。当两者同时存在于项目中时开发者经常会遇到以下典型报错Caused by: java.lang.NoSuchMethodError: net.sf.jsqlparser.statement.select.PlainSelect.getSelectItems()Ljava/util/List;这个错误的本质是两者依赖的jsqlparser版本不兼容。jsqlparser是一个SQL语句解析器MyBatis-Plus 3.x版本默认依赖jsqlparser 4.0版本而PageHelper 5.x版本要求jsqlparser 3.2版本。当Maven依赖传递导致版本冲突时就会抛出上述方法找不到的异常。2. 依赖冲突的根因分析2.1 技术栈依赖关系图MyBatis-Plus 3.5.3 └── jsqlparser 4.5 PageHelper 5.3.2 └── jsqlparser 3.22.2 版本不兼容的具体表现两个库对jsqlparser的依赖差异主要体现在API变更jsqlparser 4.0对SelectItem相关接口做了重构移除了getSelectItems()方法包路径变化3.x版本使用com.github.jsqlparser4.x改为net.sf.jsqlparser语法解析逻辑分页语句的解析方式在4.x版本有重大调整3. 解决方案设计与验证3.1 方案一统一使用MyBatis-Plus分页推荐!-- 移除PageHelper依赖 -- dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper/artifactId version5.3.2/version exclusions exclusion groupIdcom.github.jsqlparser/groupId artifactIdjsqlparser/artifactId /exclusion /exclusions /dependency !-- 确保使用MP默认的jsqlparser -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency配置MyBatis-Plus分页拦截器Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }3.2 方案二强制指定jsqlparser版本properties jsqlparser.version3.2/jsqlparser.version /properties dependencies dependency groupIdcom.github.jsqlparser/groupId artifactIdjsqlparser/artifactId version${jsqlparser.version}/version /dependency dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper/artifactId version5.3.2/version /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version exclusions exclusion groupIdnet.sf.jsqlparser/groupId artifactIdjsqlparser/artifactId /exclusion /exclusions /dependency /dependencies注意此方案可能导致MyBatis-Plus部分SQL解析功能异常4. 混合使用场景的特殊处理4.1 分页插件执行顺序控制当必须同时使用两个分页插件时需要通过Order注解明确指定拦截器顺序Configuration public class PageConfig { Bean Order(0) public PageInterceptor pageInterceptor() { return new PageInterceptor(); } Bean Order(1) public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); return interceptor; } }4.2 动态切换分页策略通过ThreadLocal实现运行时分页策略切换public class PageContext { private static final ThreadLocalBoolean MP_PAGE ThreadLocal.withInitial(() - false); public static void useMpPage() { MP_PAGE.set(true); } public static boolean isMpPage() { return MP_PAGE.get(); } } // 在Service层按需切换 public PageResultUser listUsers(PageParam param) { try { PageContext.useMpPage(); PageUser page new Page(param.getPageNum(), param.getPageSize()); return userMapper.selectPage(page, null); } finally { PageContext.remove(); } }5. 生产环境验证要点5.1 兼容性测试清单基础分页功能测试正常页码请求超出范围的页码处理pageSize边界值验证复杂SQL场景验证多表联查分页包含子查询的分页带有聚合函数的分页性能压测指标10万级数据量分页响应时间高并发下的稳定性内存占用监控5.2 常见故障排查指南现象可能原因解决方案分页总数不准1. 子查询未正确处理2. 关联查询重复计数1. 使用SqlParser注解过滤2. 自定义count查询排序失效1. 多个拦截器顺序冲突2. SQL注入过滤1. 调整拦截器顺序2. 检查安全策略配置内存泄漏1. PageHelper未调用clearPage2. 大结果集未流式处理1. 添加finally清理2. 使用游标查询6. 进阶优化方案6.1 自定义分页拦截器继承PaginationInnerInterceptor实现方言扩展public class CustomPaginationInterceptor extends PaginationInnerInterceptor { Override protected void handlerDialect(MetaObject metaObject, String sql) { if (isOracle()) { // 处理Oracle特殊分页语法 String newSql SELECT * FROM ( SELECT ROW_.*, ROWNUM ROWNUM_ FROM ( sql ) ROW_ WHERE ROWNUM ?) WHERE ROWNUM_ ?; metaObject.setValue(sql, newSql); } else { super.handlerDialect(metaObject, sql); } } }6.2 性能优化技巧Count查询优化Select(SELECT COUNT(1) FROM user WHERE status #{status}) long countByStatus(Param(status) int status);延迟关联策略-- 先获取id集合 SELECT id FROM table WHERE conditions LIMIT ?,? -- 再通过IN查询获取完整数据 SELECT * FROM table WHERE id IN (ids)游标分页实现try (CursorUser cursor userMapper.scan(limit)) { cursor.forEach(user - process(user)); }在实际项目中使用混合分页方案时建议建立严格的code review机制。我们团队通过Git预提交钩子强制检查分页相关的依赖声明确保不会出现版本冲突。对于核心业务的分页查询建议在单元测试中加入SQL解析验证环节使用Mockito模拟不同jsqlparser版本的行为差异
