springboot整合PageHelper分页失效(架包导入正确)

 刚使用PageHelper做分页时,遇到的一个平时没注意的点,导致分页不生效。分享出来给以后遇到类似问题的小伙伴一个参考

1.首先确保架包引用正确

<dependency>
			<groupId>com.github.pagehelper</groupId>
			<artifactId>pagehelper-spring-boot-starter</artifactId>
			<version>1.2.5</version>
		</dependency>

		<dependency>
			<groupId>com.github.pagehelper</groupId>
			<artifactId>pagehelper-spring-boot-autoconfigure</artifactId>
			<version>1.2.5</version>
		</dependency>

2.有坑的代码

 PageHelper.startPage(pageNum, 10);
            List<Task> taskList = projectServe.getMyTask(userName, timeOne, timeTwo, status, projectId, 1);//查询接口

3.解决后的代码

PageHelper.startPage(pageNum, 10);
        List<Task> myTask = projectMapper.getMyTaskList(userName, beginTime, endTime, status,projectId);

4原因

PageHelper.statPage(page,pageSize),这个配置一定要放在在你要分页的Mapper语句上,而不是逻辑接口上。当一个方法中有多个查询语句时,只有紧跟在PageHelper.starPage()方法后的查询结果才会分页

### SpringBootPageHelper 分页失效的原因及解决方案 #### 1. **依赖版本冲突** 如果 `pom.xml` 文件中引入的依赖存在版本不兼容的情况,可能会导致分页功能无法正常工作。例如,当 MyBatis 和 MyBatis-Plus 同时被引入项目时,可能存在重复定义拦截器的现象,从而影响到 PageHelper 的正常使用[^3]。 解决方案是在引入 PageHelper 依赖时,通过 `<exclusions>` 排除可能引起冲突的组件: ```xml <dependency> <groupId>com.github.pagehelper</groupId> <artifactId>pagehelper-spring-boot-starter</artifactId> <version>1.2.10</version> <exclusions> <exclusion> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> </exclusion> </exclusions> </dependency> ``` #### 2. **未正确配置拦截器** 在某些情况下,即使引入了正确的依赖,如果未在全局范围内注册 PageHelper 拦截器,则可能导致分页逻辑未能生效。通常可以通过以下方式完成拦截器的自动注入: 配置类中启用 PageInterceptor 注册: ```java @Configuration public class MyBatisConfig { @Bean public PageInterceptor pageInterceptor() { PageInterceptor interceptor = new PageInterceptor(); Properties properties = new Properties(); properties.setProperty("supportMethodsArguments", "true"); properties.setProperty("reasonable", "true"); interceptor.setProperties(properties); return interceptor; } } ``` #### 3. **SQL 查询语句不符合要求** PageHelper 插件仅支持特定形式的查询语句。如果 SQL 编写不当(如缺少必要的返回字段或条件),则可能导致分页失败。确保查询方法遵循标准结构并调用了对应的分页接口函数[^2]。 使用示例代码如下所示: ```java import com.github.pagehelper.PageHelper; import com.github.pagehelper.PageInfo; List<User> userList = PageHelper.startPage(pageNum, pageSize).doSelectPage(() -> userMapper.selectAll()); PageInfo<User> pageInfo = new PageInfo<>(userList); System.out.println("总记录数:" + pageInfo.getTotal()); ``` #### 4. **事务管理问题** 当数据库操作涉及分布式事务或者嵌套事务场景下,可能出现缓存机制干扰实际执行计划的情形,进而引发分页异常现象。此时建议调整隔离级别或将敏感部分单独封装成无状态服务单元运行[^1]。 --- ### 总结 综上所述,Spring Boot 应用程序中的 PageHelper 分页失效主要源于以下几个方面:依赖冲突、缺乏必要配置项以及潜在业务流程设计缺陷等问题。针对上述情况逐一排查可以有效定位具体故障所在位置,并采取相应措施加以修复。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值