MyBatis-Plus iPage工具，PostgreSQL大数据列表高效分页查询方案

当前处理大数据量列表检索展示时，高效分页是Web或应用系统的核心需求，传统MyBatis手写PostgreSQL（PG）这类主流数据库的分页SQL，需手动拼接limit/offset、统计总行数，易出错且复用性弱，MyBatis-Plus的iPage分页组件可轻松解决此问题：只需引入依赖、配置实体映射、注入BaseMapper或继承它，调用selectPage等方法并传入IPage实例，就能自动返回含总条数、当前页数据的封装结果，其内置PG等常见方言支持，无需复杂适配，大幅简化分页开发。

在开发Web应用时,我们经常会遇到“大数据列表展示”的场景——比如电商平台的商品列表、后台管理系统的用户记录、社交应用的动态流等，如果一次性将所有数据加载到前端，不仅会导致页面加载缓慢，还可能造成服务器内存溢出、数据库压力过大，这时，分页查询就是解决这类问题的核心方法，而MyBatis-Plus中的iPage（即Page<T>对象）更是简化分页开发的利器。

什么是iPage分页查询？

iPage通常指MyBatis-Plus框架中的分页对象Page<T>，它是框架为简化分页操作封装的核心类。Page<T>不仅包含了分页的关键参数（当前页码、每页条数），还会自动封装查询结果的元信息（总记录数、总页数、当前页数据列表等），配合MyBatis-Plus的分页插件，它可以自动将普通SQL改造为分页SQL（如MySQL的LIMIT语句），让开发者无需手动编写繁琐的分页逻辑。

为什么选择iPage分页查询？

相比传统的手动编写分页SQL,iPage有以下优势：

性能优化

避免一次性查询大量数据,减少数据库IO消耗和服务器内存占用，提升系统稳定性。

开发效率高

无需手动拼接LIMIT、COUNT等语句，框架自动处理分页逻辑，代码更简洁。

通用性强

支持多种数据库（MySQL、Oracle、PostgreSQL等），只需在配置时指定数据库类型即可。

结果封装完善

返回的Page<T>对象直接包含前端需要的所有分页信息，方便前端渲染。

iPage分页查询的实战步骤

下面以Spring Boot + MyBatis-Plus为例，手把手教你实现iPage分页查询。

步骤1：引入MyBatis-Plus依赖

在pom.xml中添加MyBatis-Plus的启动器（以3.5.3版本为例）：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3</version>
</dependency>

步骤2：配置分页插件

MyBatis-Plus 3.4.0之后推荐使用MybatisPlusInterceptor配置分页插件，需指定数据库类型：

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加分页插件，指定数据库类型为MySQL
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

步骤3：定义实体类和Mapper

假设我们有一个User实体类，对应数据库的user表：

@Data
@TableName("user") // 对应数据库表名
public class User {
    @TableId(type = IdType.AUTO) // 主键自增
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

Mapper接口继承MyBatis-Plus的BaseMapper<T>，自动获得基础CRUD方法：

public interface UserMapper extends BaseMapper<User> {
    // 如需复杂查询，可自定义分页方法（参数中需包含Page对象）
    Page<User> selectUserByAge(Page<User> page, @Param("minAge") Integer minAge);
}

步骤4：Service层实现分页逻辑

在Service层创建Page<T>对象，传入当前页码和每页条数，调用Mapper方法：

@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;
    // 简单分页查询（无条件）
    public Page<User> getUserPage(int currentPage, int pageSize) {
        // 初始化Page对象：currentPage=当前页，pageSize=每页条数
        Page<User> page = new Page<>(currentPage, pageSize);
        // 调用BaseMapper的selectPage方法，第二个参数为查询条件（null表示无条件）
        return userMapper.selectPage(page, null);
    }
    // 带条件的分页查询
    public Page<User> getUserPageByAge(int currentPage, int pageSize, Integer minAge) {
        Page<User> page = new Page<>(currentPage, pageSize);
        // 使用LambdaQueryWrapper构建查询条件（年龄大于minAge）
        LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
        wrapper.gt(User::getAge, minAge);
        return userMapper.selectPage(page, wrapper);
    }
}

步骤5：Controller层暴露接口

在Controller中接收前端传来的分页参数,调用Service并返回结果：

@RestController
@RequestMapping("/user")
public class UserController {
    @Autowired
    private UserService userService;
    // 简单分页接口：默认第1页，每页10条
    @GetMapping("/page")
    public Page<User> getUserPage(@RequestParam(defaultValue = "1") int currentPage,
                                  @RequestParam(defaultValue = "10") int pageSize) {
        return userService.getUserPage(currentPage, pageSize);
    }
    // 带条件的分页接口
    @GetMapping("/pageByAge")
    public Page<User> getUserPageByAge(@RequestParam(defaultValue = "1") int currentPage,
                                       @RequestParam(defaultValue = "10") int pageSize,
                                       @RequestParam Integer minAge) {
        return userService.getUserPageByAge(currentPage, pageSize, minAge);
    }
}

iPage返回结果解析

调用接口后,返回的Page<T>对象包含以下核心字段： | 字段 | 含义 | 示例值 | |------------|--------------------|---------| | records | 当前页的数据列表 | [User1, User2, ...] | | total | 总记录数 | 100 | | size | 每页条数 | 10 | | current | 当前页码 | 1 | | pages | 总页数 | 10 |

前端可以直接利用这些字段渲染分页组件（如Element UI的el-pagination）。

常见问题与注意事项

1. 分页插件未配置：如果忘记配置MybatisPlusInterceptor，查询时不会分页，会返回所有数据。
2. 页码起始值：Page<T>默认当前页从1开始，如果前端传0，需在代码中调整（如currentPage = Math.max(currentPage, 1)）。
3. 数据库类型匹配：配置PaginationInnerInterceptor时需指定正确的DbType，否则分页SQL会报错（如Oracle用ROWNUM，MySQL用LIMIT）。
4. 自定义SQL：如果在Mapper.xml中写自定义SQL，无需手动加LIMIT，插件会自动在SQL末尾拼接分页语句。

iPage分页查询通过MyBatis-Plus的封装，将复杂的分页逻辑简化为几行代码，既提升了开发效率，又保证了系统性能，无论是简单的单表分页还是复杂的多表联查，iPage都能轻松应对，是处理大数据列表的首选方案。

如果你还在手动编写分页SQL,不妨试试iPage，让你的开发工作更轻松！

---

ipage分页查询、MyBatis-Plus、分页插件、大数据列表、Spring Boot