一、分页查询的核心价值与适用场景

在Web开发中，分页查询是处理大数据集的核心技术之一。当查询结果超过单页承载能力时（如电商商品列表、日志记录等），分页能有效降低网络传输压力，提升用户体验。MyBatis-Plus作为MyBatis的增强工具，通过内置的分页插件简化了传统分页实现中需手动编写LIMIT offset, size的繁琐过程，同时支持物理分页与内存分页两种模式。

典型应用场景：

1. 用户列表展示（如后台管理系统）
2. 报表数据分页导出
3. 无限滚动加载实现
4. 复杂关联查询的分页优化

二、MyBatis-Plus分页原理深度解析

1. 拦截器机制

MyBatis-Plus通过PaginationInnerInterceptor拦截SQL执行流程，在执行前自动修改SQL语句，追加分页参数。例如将：

SELECT * FROM user WHERE age > 18

转换为：

SELECT * FROM user WHERE age > 18 LIMIT 0,10

同时执行COUNT(*)统计总数，返回Page<T>对象包含分页元数据。

2. 分页参数对象

核心类Page<T>包含三个关键属性：

• current：当前页码（从1开始）
• size：每页记录数
• orders：排序条件（支持多字段排序）

示例创建分页对象：

Page<User> page = new Page<>(1, 10);
page.addOrder(OrderItem.desc("create_time"));

三、基础实现三步曲

1. 配置分页插件（Spring Boot环境）

在配置类中添加Bean定义：

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

支持多种数据库类型（DbType.ORACLE/DbType.POSTGRE_SQL等）。

2. Mapper接口定义

继承BaseMapper<T>即可获得分页方法：

public interface UserMapper extends BaseMapper<User> {
    // 无需额外方法定义
}

3. Service层调用

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserMapper userMapper;
    public Page<User> queryUserPage(Long current, Long size) {
        Page<User> page = new Page<>(current, size);
        return userMapper.selectPage(page, null);
    }
}

四、高阶功能实现

1. 自定义SQL分页

对于复杂查询，可在XML中定义分页SQL：

<select id="selectCustomPage" resultType="User">
    SELECT u.* FROM user u 
    LEFT JOIN department d ON u.dept_id = d.id
    ${ew.customSqlSegment}
</select>

Service层调用：

LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
wrapper.eq(User::getStatus, 1);
Page<User> page = new Page<>(1, 5);
userMapper.selectPage(page, wrapper);

2. 多表关联分页优化

针对关联查询的性能问题，建议：

1. 先分页再关联（推荐）
   ```java
   // 先查询主表ID分页
   Page idPage = new Page<>(1, 10);
   LambdaQueryWrapper idWrapper = new LambdaQueryWrapper<>();
   idWrapper.select(User::getId);
   userMapper.selectPage(idPage, idWrapper);

// 再批量查询详情
List ids = idPage.getRecords();
List users = userMapper.selectBatchIds(ids);

2. 使用子查询优化
```sql
SELECT u.* FROM user u 
WHERE u.id IN (
    SELECT id FROM user 
    WHERE status = 1 
    LIMIT 0,10
)

3. 性能监控与调优

通过PerformanceInterceptor监控分页SQL执行：

@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
    interceptor.addInnerInterceptor(new PerformanceInterceptor());
    return interceptor;
}

关键优化点：

• 避免COUNT(*)全表扫描（可考虑缓存总数）
• 对分页字段建立索引
• 大数据量时限制最大页数（如page.setSize(1000).setMaxLimit(5000)）

五、常见问题解决方案

1. 分页总数不准确

问题原因：多表关联导致COUNT(*)结果异常。
解决方案：

// 使用自定义COUNT查询
Page<User> page = new Page<>(1, 10);
page.setOptimizeCountSql(false); // 关闭自动COUNT
// 手动执行COUNT查询
Long total = userMapper.selectCount(wrapper);
List<User> records = userMapper.selectList(wrapper.last("LIMIT " + (page.getCurrent()-1)*page.getSize() + "," + page.getSize()));
return new Page<>(page.getCurrent(), page.getSize(), total).setRecords(records);

2. 复杂排序处理

支持多字段动态排序：

public Page<User> sortPage(Integer current, Integer size, String sortField, String sortOrder) {
    Page<User> page = new Page<>(current, size);
    if ("asc".equalsIgnoreCase(sortOrder)) {
        page.addOrder(OrderItem.asc(sortField));
    } else {
        page.addOrder(OrderItem.desc(sortField));
    }
    return userMapper.selectPage(page, null);
}

3. 物理分页与内存分页选择

特性	物理分页（推荐）	内存分页
数据量	大数据集（万级以上）	小数据集（千级以下）
性能	高（数据库层面分页）	低（需加载全部数据）
实现复杂度	低（自动生成SQL）	高（需手动处理）

六、最佳实践建议

1. 分页大小控制：建议每页10-50条记录，移动端可适当减少
2. 默认页码处理：当current参数超出范围时，自动调整到第一页或最后一页
3. 缓存策略：对不常变动的数据（如字典表）可缓存分页结果
4. 安全防护：限制最大分页参数（如page.setSize(100).setMaxLimit(1000)）
5. 异步加载：前端配合实现懒加载，提升用户体验

通过合理使用MyBatis-Plus的分页功能，开发者可以快速构建高效、稳定的数据分页方案。实际开发中，建议结合具体业务场景选择合适的实现方式，并通过性能测试验证优化效果。