springboot+pagehelper踩坑，PageHelper.startPage没有生效问题

最新推荐文章于 2026-04-07 21:58:32 发布

原创最新推荐文章于 2026-04-07 21:58:32 发布 · 9.8k 阅读

16 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#spring boot

本文介绍如何在SpringBoot项目中使用PageHelper实现分页功能，包括正确的依赖版本配置及使用方式，解决之前配置无效的问题。

springboot+pagehelper踩坑

首先是项目依赖，我是2.1.6.RELEASE版本的springboot，导入pagehelper版本为1.3.0，mybatis版本为2.1.4，如下所示：

<dependency>
			<groupId>com.github.pagehelper</groupId>
			<artifactId>pagehelper-spring-boot-starter</artifactId>
			<version>1.3.0</version>
		</dependency>
<dependency>
			<groupId>org.mybatis.spring.boot</groupId>
			<artifactId>mybatis-spring-boot-starter</artifactId>
			<version>2.1.4</version>
		</dependency>

使用方式

在PageHelper.startPage后紧跟逻辑执行，如下所示：

PageHelper.startPage(1,5);
//查询方法
List<Syshref> list = mapper.findtest();

失效原因

之前的配置是放在application.properties中的：

pagehelper.dialect=com.github.pagehelper.dialect.helper.MySqlDialect
pagehelper.reasonable=false
pagehelper.support-methods-arguments=true
pagehelper.params=count=countSql

试了网上很多种方法，都没有分页成功

后来将配置单独拎出来放在java文件中就可以正常分页了

import com.github.pagehelper.PageHelper;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.Properties;
@Configuration
public class PageHelperConfigure {
    @Bean
    public PageHelper pageHelper() {
        PageHelper pageHelper = new PageHelper();
        //添加配置，也可以指定文件路径
        Properties p = new Properties();
        p.setProperty("offsetAsPageNum", "true");
        p.setProperty("rowBoundsWithCount", "true");
        p.setProperty("reasonable", "true");
        pageHelper.setProperties(p);
        return pageHelper;
    }
}