springboot注入分页插件(pagehelper)不生效

本文介绍在SpringBoot项目中遇到PageHelper分页插件未生效的问题及解决办法。通过手动注入分页插件并将其添加到MyBatis的拦截器数组中,确保分页功能正常工作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

本项目使用pagehelper过程中发现分页不生效

相关配置如下

springboot的分页插件

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

分页插件注入,我这里代码都是手动注入

   @Bean
    public PageHelper pageHelper() {
        PageHelper pageHelper = new PageHelper();
        Properties p = new Properties();
        p.setProperty("helperDialect", "Mysql");
        p.setProperty("supportMethodsArguments", "true");
        p.setProperty("reasonable", "false");
        p.setProperty("params", "count=countSql");
        pageHelper.setProperties(p);
        return pageHelper;
    }
代码如下:

image
image

生成SQL中并没有分页代码
debug中发现注入mybatis的插件拦截器数组中并没有分页插件 如图:
image

解决方案

在注入分页插件的同时注入mybatis 插件拦截器数组

注意
如果手动注入拦截器,那所有的mybatis插件拦截器都要在这里注入。

    @Bean
    public PageHelper pageHelper() {
        PageHelper pageHelper = new PageHelper();
        Properties p = new Properties();
        p.setProperty("helperDialect", "Mysql");
        p.setProperty("supportMethodsArguments", "true");
        p.setProperty("reasonable", "false");
        p.setProperty("params", "count=countSql");
        pageHelper.setProperties(p);
        return pageHelper;
    }
    /**
     * 给mybatis注入分页插件
     * 防止mybatis分页插件不生效
     **/
    @Bean
    public Interceptor[] plugins() {
        return new Interceptor[]{new PageInterceptor()};
    }
运行成功结果

image

成功获取到了 插件数组

image

分页插件生效

### 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 分页失效主要源于以下几个方面:依赖冲突、缺乏必要配置项以及潜在业务流程设计缺陷等问题。针对上述情况逐一排查可以有效定位具体故障所在位置,并采取相应措施加以修复。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值