Mybatis-PageHelper分页方法offsetPage的正确使用姿势

在Mybatis-PageHelper分页插件中，offsetPage方法是一个常用的静态分页方法，但很多开发者对其参数含义存在误解。本文将从分页原理出发，深入解析offsetPage方法的正确使用方式。

方法参数解析

offsetPage方法接收两个关键参数：

• 第一个参数表示偏移量（offset），即从第几条记录开始查询
• 第二个参数表示每页大小（pageSize），即每页显示的记录数

这里需要特别注意：偏移量的计数是从0开始的，这与数据库的LIMIT语法保持一致。例如：

PageHelper.offsetPage(0, 10);  // 查询第1-10条记录
PageHelper.offsetPage(10, 10); // 查询第11-20条记录

与startPage方法的区别

PageHelper还提供了startPage方法，其参数含义与offsetPage不同：

PageHelper.startPage(1, 10);  // 查询第1页，每页10条
PageHelper.startPage(2, 10);  // 查询第2页，每页10条

startPage的第一个参数是页码（从1开始），而offsetPage的第一个参数是偏移量（从0开始）。这是两个方法最本质的区别。

实际应用建议

1. 前端分页场景：推荐使用startPage方法，因为前端通常传递的是页码参数
2. 特殊分页需求：当需要跳过固定数量的记录时，使用offsetPage更为直观
3. API设计一致性：团队内部应统一使用一种风格，避免混用造成混淆

常见误区

很多开发者误以为offsetPage(1,10)表示查询第一页的10条记录，这实际上会跳过第一条记录，从第二条开始查询。正确的做法应该是使用offsetPage(0,10)来获取第一页数据。

理解这些分页方法的差异，可以帮助开发者更精准地控制数据查询范围，避免出现数据遗漏或重复的问题。在实际项目中，建议根据具体场景选择最适合的分页方式，并在团队内部保持使用规范的一致性。