1. MyBatis-Plus分页机制深度解析
MyBatis-Plus作为MyBatis的增强工具，其分页功能一直是开发者高频使用的核心特性。在实际项目中，我们经常会遇到需要限制单页最大数据量的场景——比如防止恶意请求大量数据导致内存溢出，或者遵循API设计规范控制响应体积。今天我就结合一个生产级案例，详细讲解如何通过PaginationInnerInterceptor实现分页限制。
重要提示：分页限制不是简单的业务逻辑，而是系统安全性和稳定性的重要保障措施。不当的分页设置可能导致数据库过载或内存溢出。
1.1 分页拦截器工作原理
MyBatis-Plus的分页功能基于拦截器机制实现，核心类是PaginationInnerInterceptor。当执行Mapper方法时，拦截器会动态修改SQL语句，添加LIMIT和OFFSET等分页关键字。整个过程分为三个阶段：
- SQL解析阶段：拦截器识别需要分页的查询方法（通常带有Page参数）
- 方言适配阶段：根据配置的DbType生成特定数据库的分页语法
- 参数替换阶段：将Page对象中的current和size值注入到SQL中
这种设计使得分页操作对开发者完全透明，我们只需要关注业务逻辑即可。
1.2 为什么需要限制单页数量
允许客户端无限制地请求大量数据会带来三大风险：
- 内存压力：一次性加载百万级数据可能导致JVM内存溢出
- 数据库负载：大偏移量查询（如LIMIT 1000000,10）会使数据库执行全表扫描
- 网络传输：大数据包传输消耗带宽且增加响应时间
我曾遇到过因未设置分页上限，导致攻击者通过构造size=1000000的请求拖慢系统的案例。设置合理的maxLimit可以有效预防这类问题。
2. 完整配置方案与参数详解
2.1 基础配置实现
以下是生产环境中推荐的完整配置方案：
java复制@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
// 分页插件配置
PaginationInnerInterceptor paginationInterceptor = new PaginationInnerInterceptor(DbType.MYSQL);
paginationInterceptor.setMaxLimit(500L); // 单页最大500条
paginationInterceptor.setOverflow(true); // 超出最大值时返回第一页
// 防止全表更新与删除插件
BlockAttackInnerInterceptor blockAttackInterceptor = new BlockAttackInnerInterceptor();
interceptor.addInnerInterceptor(paginationInterceptor);
interceptor.addInnerInterceptor(blockAttackInterceptor);
return interceptor;
}
}
2.2 关键参数说明
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| maxLimit | Long | null | 单页最大记录数，null表示不限制 |
| overflow | boolean | false | 页码溢出时是否返回第一页 |
| dbType | DbType | 无 | 数据库类型，影响分页方言生成 |
| optimizeJoin | boolean | true | 是否优化JOIN查询的分页 |
其中maxLimit和overflow的配合使用特别重要：
- 当page.size > maxLimit时：
- overflow=false：使用maxLimit作为实际size
- overflow=true：返回第一页数据
2.3 多数据库类型适配
对于多数据源项目，需要针对不同数据库配置对应的方言：
java复制// PostgreSQL配置示例
PaginationInnerInterceptor pgInterceptor = new PaginationInnerInterceptor(DbType.POSTGRE_SQL);
pgInterceptor.setMaxLimit(1000L);
// Oracle配置示例
PaginationInnerInterceptor oracleInterceptor = new PaginationInnerInterceptor(DbType.ORACLE);
oracleInterceptor.setMaxLimit(200L);
不同数据库的分页语法差异很大，正确设置DbType可以确保生成正确的分页SQL。
3. 实战应用与接口设计
3.1 Controller层最佳实践
推荐使用统一的分页参数接收对象：
java复制@GetMapping("/list")
public R<Page<Student>> listStudents(
@RequestParam(defaultValue = "1") int current,
@RequestParam(defaultValue = "10") int size) {
Page<Student> page = new Page<>(current, size);
return R.ok(studentService.page(page));
}
3.2 Service层优化技巧
在Service层可以添加业务逻辑过滤：
java复制@Override
public Page<Student> page(Page<Student> pageParam) {
// 确保分页参数合法
if(pageParam.getSize() > 100) {
pageParam.setSize(100);
}
return this.lambdaQuery()
.eq(Student::getStatus, 1)
.page(pageParam);
}
3.3 前端分页组件对接
前端分页组件通常需要以下响应结构：
json复制{
"code": 200,
"data": {
"records": [...],
"total": 1250,
"size": 10,
"current": 1,
"pages": 125
}
}
可以通过自定义Page对象实现：
java复制public class R<T> {
public static <T> R<Page<T>> ok(Page<T> page) {
Map<String, Object> data = new HashMap<>();
data.put("records", page.getRecords());
data.put("total", page.getTotal());
data.put("size", page.getSize());
data.put("current", page.getCurrent());
data.put("pages", page.getPages());
return new R<>(200, data);
}
}
4. 性能优化与问题排查
4.1 大表分页优化方案
当处理百万级数据表时，传统LIMIT分页会出现性能问题。推荐两种优化方案：
- 游标分页：
sql复制SELECT * FROM table WHERE id > last_id ORDER BY id LIMIT 10
- 延迟关联：
sql复制SELECT * FROM table INNER JOIN (
SELECT id FROM table ORDER BY create_time DESC LIMIT 10000, 10
) AS tmp USING(id)
4.2 常见错误排查
问题1：分页失效，返回全部数据
- 检查Mapper方法是否使用了Page参数
- 确认拦截器已正确配置并注入Spring容器
问题2：count查询执行缓慢
- 添加适当的索引
- 使用@SqlParser注解过滤不需要count的场景
问题3：分页结果不准确
- 检查是否有自定义的拦截器修改了SQL
- 确认数据库事务隔离级别设置正确
4.3 监控与调优建议
- 添加SQL执行时间监控：
java复制@InterceptorOrder(1)
public class PerformanceInterceptor implements Interceptor {
@Override
public Object intercept(Invocation invocation) {
long start = System.currentTimeMillis();
Object result = invocation.proceed();
long end = System.currentTimeMillis();
log.debug("SQL执行耗时：{}ms", end - start);
return result;
}
}
- 合理设置maxLimit值：
- 管理后台：建议100-500条
- 移动端API：建议10-50条
- 报表导出：可适当放宽至1000条
5. 扩展功能实现
5.1 自定义分页逻辑
继承PaginationInnerInterceptor实现特殊需求：
java复制public class CustomPaginationInterceptor extends PaginationInnerInterceptor {
@Override
public void beforeQuery(Executor executor, MappedStatement ms,
Object parameter, RowBounds rowBounds, ResultHandler resultHandler,
BoundSql boundSql) {
// 特殊场景跳过分页
if(shouldSkipPagination(parameter)) {
return;
}
super.beforeQuery(...);
}
}
5.2 多租户分页处理
在SAAS系统中，分页需要结合租户隔离：
java复制@Override
public void beforeQuery(...) {
// 添加租户过滤条件
String tenantFilter = " AND tenant_id = " + TenantContext.getCurrentId();
String newSql = boundSql.getSql() + tenantFilter;
resetSql(ms, boundSql, newSql);
super.beforeQuery(...);
}
5.3 分布式环境下的分页
当数据分布在多个节点时，可以采用以下策略：
-
全局排序分页：
- 各节点查询数据
- 协调节点合并排序后分页
-
分片路由分页：
- 根据分片键确定数据位置
- 只在目标分片执行分页查询
实际项目中，分页限制的设置需要结合具体业务场景。我一般会根据接口的使用方（如移动端、管理后台、第三方对接）设置不同的maxLimit值，并通过API文档明确告知调用方分页限制规则