MyBatis-Plus分页插件：实现数据分页查询

fyakm

2508人浏览 · 2025-11-08 09:00:00

fyakm · 2025-11-08 09:00:00 发布

在数据库操作中，当数据量较大时，一次性查询所有数据不仅会消耗大量的系统资源，还会影响查询性能和用户体验。这时，数据的分页查询就显得尤为重要。MyBatis-Plus 提供了强大的分页插件，能够帮助我们轻松实现数据的分页查询。接下来，我们就一起深入了解 MyBatis-Plus 分页插件的配置和使用方法。

分页插件的核心技术点

核心原理

MyBatis-Plus 的分页插件本质上是一个拦截器，它会在执行 SQL 查询时拦截原始的 SQL 语句，根据我们传入的分页参数，自动生成分页查询的 SQL 语句。简单来说，就是在我们原本要查询所有数据的 SQL 基础上，加上了 LIMIT 关键字，来限制查询结果的数量和起始位置。

例如，我们原本的 SQL 是 SELECT * FROM user，如果我们要查询第 2 页，每页 10 条数据，分页插件会将其转换为 SELECT * FROM user LIMIT 10, 10。这样就只查询出了我们需要的那部分数据，避免了一次性查询大量数据。

优势

简化开发：使用分页插件，我们不需要手动编写复杂的分页 SQL，只需要配置好插件，传入分页参数，就可以实现分页查询，大大减少了开发工作量。
性能优化：分页查询可以减少每次查询的数据量，降低数据库的压力，提高查询性能。同时，分页插件还会自动处理一些性能优化的问题，如优化 SQL 语句等。

分页插件的配置和使用方法

步骤 1：配置分页插件

首先，我们需要在项目中配置分页插件。在 Spring Boot 项目中，我们可以通过创建一个配置类来完成插件的配置。以下是示例代码：

import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MyBatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
        return interceptor;
    }
}

在上述代码中，我们创建了一个 MyBatisPlusConfig 配置类，在该类中定义了一个 mybatisPlusInterceptor 方法，该方法返回一个 MybatisPlusInterceptor 对象。我们通过 addInnerInterceptor 方法向 MybatisPlusInterceptor 中添加了一个 PaginationInnerInterceptor，这个 PaginationInnerInterceptor 就是我们的分页插件。

步骤 2：创建分页对象

在进行分页查询之前，我们需要创建一个分页对象，来指定我们要查询的页码和每页的数据量。以下是示例代码：

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    public IPage<User> getUserPage(int pageNum, int pageSize) {
        // 创建分页对象，pageNum 为页码，pageSize 为每页数据量
        Page<User> page = new Page<>(pageNum, pageSize);
        return userMapper.selectPage(page, null);
    }
}

在上述代码中，我们创建了一个 Page 对象，传入了页码 pageNum 和每页数据量 pageSize。这个 Page 对象就是我们的分页对象，它实现了 IPage 接口。

步骤 3：调用 Mapper 接口的分页查询方法

创建好分页对象后，我们就可以调用 Mapper 接口的分页查询方法来进行分页查询了。以下是示例代码：

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface UserMapper extends BaseMapper<User> {
}

// 在 Service 层调用分页查询方法
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    public IPage<User> getUserPage(int pageNum, int pageSize) {
        Page<User> page = new Page<>(pageNum, pageSize);
        // 调用 Mapper 接口的分页查询方法
        return userMapper.selectPage(page, null);
    }
}

在上述代码中，我们的 UserMapper 接口继承了 BaseMapper 接口，BaseMapper 接口中已经提供了 selectPage 方法用于分页查询。我们在 UserService 中调用 userMapper.selectPage 方法，传入分页对象和查询条件（这里查询条件为 null，表示查询所有数据），就可以得到分页查询的结果。

分页流程图表展示

实操模块

以下是一个完整的 Java 代码示例，展示了如何使用 MyBatis-Plus 分页插件实现数据的分页查询：

1. 实体类 `User.java`

import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

@Data
@TableName("user")
public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

2. Mapper 接口 `UserMapper.java`

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface UserMapper extends BaseMapper<User> {
}

3. Service 层 `UserService.java`

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    public IPage<User> getUserPage(int pageNum, int pageSize) {
        Page<User> page = new Page<>(pageNum, pageSize);
        return userMapper.selectPage(page, null);
    }
}

4. Controller 层 `UserController.java`

import com.baomidou.mybatisplus.core.metadata.IPage;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/users")
    public IPage<User> getUsers(@RequestParam(defaultValue = "1") int pageNum,
                                @RequestParam(defaultValue = "10") int pageSize) {
        return userService.getUserPage(pageNum, pageSize);
    }
}

问题解决

分页查询数据不准确问题

问题原因：可能是分页参数传递错误，或者数据库中的数据发生了变化。
解决方法：检查分页参数是否正确，确保页码和每页数据量的设置符合预期。同时，在进行分页查询时，尽量保证数据的一致性，避免在查询过程中对数据进行修改。

分页插件配置错误问题

问题原因：可能是分页插件没有正确配置，或者配置类没有被 Spring 容器扫描到。
解决方法：检查分页插件的配置代码，确保 MybatisPlusInterceptor 和 PaginationInnerInterceptor 正确添加。同时，检查配置类是否添加了 @Configuration 注解，并且被 Spring 容器扫描到。