大家好，我是晚安code。

写过几轮 CRUD 的朋友，下面这两件事你大概率天天干：分页查询要手写 `count` 加 `limit`，换张表就改一遍；每次 `insert` 前还得手动 `setCreateTime()`，漏一次线上就埋个坑。这两件破事，MyBatis-Plus 两个内置能力就能全包圆——分页插件和字段自动填充，两行配置，一次配好。今天用「用户管理」当例子，把思路和代码都给你捋清楚，收藏这篇，下次直接抄。

## 一、写 CRUD 时最烦的两件事

先说说痛点，你肯定有共鸣。

**第一件，分页查询。** 早期写分页，每张表都得 copy 一份带 `count` 和 `limit` 的 SQL，还得手动算 offset。表一多，光维护这些分页语句就够呛，改个页码逻辑还得小心别把 SQL 拼错。

**第二件，审计字段。** 也就是 `create_time`、`update_time` 这种"谁在什么时候干的"的字段。每次新增、每次修改，都要在 Service 里手动 set 一遍当前时间。手一抖忘了，数据库里就留下一条没有时间戳的记录，排查时一脸懵。

![](https://developer.qcloudimg.com/http-save/yehe-12591818/90a5096f35fb8fe98c3f009a81a067aa.webp)

> 

![手动分页 + 手动填时间，写一次还好，每张表都来一遍就破防了。](https://developer.qcloudimg.com/http-save/yehe-12591818/5f673450a45cc26e6608d409d96b2d27.png)

## 二、MyBatis-Plus 到底是什么

**MyBatis-Plus（MP）**：MyBatis 的增强工具，只做增强不做改变，不会影响你已有的 MyBatis 代码。你可以理解为「MyBatis 的自动挡」——不用换发动机，挂个挡就能自动换挡。

它最拿手的，就是把单表 CRUD 里那些写烦了的模板代码收编成内置能力。分页、条件查询、逻辑删除、字段填充，这些在原生 MyBatis 里要手写的地方，MP 都替你包好了。

## 三、分页插件：一页一页查，不用再拼 SQL

分页插件解决的不是"能不能分页"，而是"别让我每张表都重写一遍 count + limit"。配一次，全项目生效。

**分页插件（PaginationInnerInterceptor）**：MyBatis-Plus 内置的分页拦截器，会自动拦截分页 SQL，帮你拼好 count 统计和 limit 截断。就像点外卖时的"自动凑满减"——你不用自己算，平台帮你凑好。

### 1）加依赖

```xml

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

### 2）注册插件

```java
// MyBatis-Plus 3.5.x，2026 年 8 月实测
@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 注册分页插件，指定数据库方言
        interceptor.addInnerInterceptor(
            new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}
```

`DbType.MYSQL` 就是告诉插件"我连的是 MySQL"，方言不同，分页拼接语法就不同。

### 3）使用

```java
// 查第 2 页，每页 10 条
Page<User> page = new Page<>(2, 10);

// 一条 SQL 都不用写，插件自动拼 count + limit
IPage<User> result = userMapper.selectPage(page, null);

// 当前页的数据
List<User> users = result.getRecords();
// 总条数，前端分页条靠它渲染
long total = result.getTotal();
```

核心就一个 `Page` 对象 + 一个 `selectPage` 方法。至于 count 怎么统计、offset 怎么算、limit 拼在哪儿，都是插件在底层替你干。

看一眼分页插件的执行链路，就明白为什么你不用写 SQL 了

## 四、踩坑：分页插件失效

> **可能有人会问：分页插件配了怎么还是不生效？**
>
> 九成是这俩原因：要么 `PaginationInnerInterceptor` 没注册进 `MybatisPlusInterceptor`（记得加进 `addInnerInterceptor`），要么 `mybatis-plus` 版本太旧，老版本分页插件类和现在不一样。先把版本升到 3.5.x 再试。

另外有个细节我踩过：**分页插件要声明在拦截器链里**。有些教程让直接 `new PaginationInnerInterceptor()` 就完事，其实它得挂在 `MybatisPlusInterceptor` 里面才算数，顺序放前面更稳妥。否则你 `selectPage` 是能调用，但 SQL 不拼 limit，全表查出来再分页——慢不说，还白折腾。

## 五、字段自动填充：创建/更新时间不用再手动

审计字段自动填充，本质是把"每次都要记得"改成"配一次永远生效"。你只管业务字段，时间戳交给框架。

**MetaObjectHandler（元对象处理器）**：MyBatis-Plus 的字段填充接口，执行 insert 或 update 时会自动回调。你可以理解为「数据库操作的自动盖章机」——插入或更新时，自动给你盖上当前时间。

**审计字段**：数据库表里 `create_time`、`update_time` 这类记录"谁、在什么时候、对数据干了什么"的字段。名字听着像审计报告，其实就是让你知道每条数据啥时候来的、啥时候改的。

### 1）实体加注解

```java
@Data
@TableName("user")
public class User {

    @TableId(type = IdType.ASSIGN_ID)
    private Long id;

    private String username;

    // 插入时自动填充
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;

    // 插入和更新时都自动填充
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}
```

`@TableField(fill = ...)` 是开关，`FieldFill.INSERT` 表示只插入时填，`FieldFill.INSERT_UPDATE` 表示插入和更新都填。写明白后，Create、Update 两个操作想让它什么时候盖时间戳，你说了算。

### 2）实现处理器

```java
// 注册成 Spring Bean，MyBatis-Plus 自动识别
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime",
                LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, "updateTime",
                LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime",
                LocalDateTime.class, LocalDateTime.now());
    }
}
```

`insertFill` 管插入，`updateFill` 管更新。注意字段名要和实体里一致，`"createTime"` 对应 `createTime`，别写成 `create_time`，不然按字段名填不上。





![业务字段你填，时间戳它盖，各干各的，互不打扰。](https://developer.qcloudimg.com/http-save/yehe-12591818/37643d1a23321ce2b041c613b38a5630.png)

## 六、踩坑：自动填充不生效

> **可能有人会问：自动填充没效果，字段还是空的？**
>
> 三个原因对号入座：① `@TableField(fill = ...)` 没写；② `MetaObjectHandler` 忘了加 `@Component`，没注册成 Spring Bean；③ `strictInsertFill` 里字段名写错，比如把 `"createTime"` 写成 `"create_time"`。

这个坑我实打实踩过。一开始漏了 `@Component`，`insert` 完了 `create_time` 还是 `null`，查了半天没头绪。

![](https://developer.qcloudimg.com/http-save/yehe-11608098/b40e186f4d30f79440dd30d1905a799a.webp)

另外说一句，`strictInsertFill` 只在字段值还是 `null` 时才填。你要是手动 set 了值，它就尊重你的值，不会覆盖。这个特性挺实用——想特殊处理的字段，你可以自己控制。

## 七、手动 vs MyBatis-Plus：一张表看清差距

手动写分页和手动填时间戳，是 CRUD 里最不值得花时间的两件事。能交给框架的，别自己扛。

| 场景 | 手动做法 | MyBatis-Plus 做法 | 你要配的 |
|------|---------|------------------|---------|
| 分页查询 | 每张表手写 count + limit，换表改一遍 | `selectPage` + `Page`，插件自动拼 SQL | 注册一个分页插件 Bean |
| 创建时间 | insert 前手动 `setCreateTime()` | `@TableField(fill = INSERT)` 自动填 | 实现 `MetaObjectHandler` |
| 更新时间 | update 前手动 `setUpdateTime()` | `INSERT_UPDATE` 插入更新都覆盖 | 同一个 handler 搞定 |

## 八、总结与延伸

这两样配好之后，我写 CRUD 基本就剩业务逻辑本身了：分页用 `Page`，时间戳交给 `MetaObjectHandler`，实体上两个注解，配置类里几行代码。短项目半天能搭完的增删改查，至少省掉一大半模板活。

我的看法很直接：**只要你的项目用了 MyBatis-Plus，分页插件和字段自动填充就该是标配，配一次长期省心。** 还没用 MP 的项目，光为了这俩能力迁移也值。

想再深入，可以翻 MyBatis-Plus 官方文档看逻辑删除、乐观锁、条件构造器（搜：MyBatis-Plus 官网 核心功能）。工具版本以 3.5.x 为准，本文随版本更新同步修订，最后更新：2026 年 8 月。

![](https://developer.qcloudimg.com/http-save/yehe-11608098/e4e295264c05896454bef803c22b8fc5.webp)

我是晚安code，持续分享编程干货。觉得有用的话记得点赞收藏和关注~也欢迎在评论区聊聊：你在用 MyBatis-Plus 时还靠它解决过哪些 CRUD 痛点？

写过几轮 CRUD 的朋友，下面这两件事你大概率天天干：分页查询要手写 count 加 limit，换张表就改一遍；每次 insert 前还得手动 setCreateTime()，漏一次线上就埋个坑。这两件破事，MyBatis-Plus 两个内置能力就能全包圆——分页插件和字段自动填充，两行配置，一次配好。今天用「用户管理」当例子，把思路和代码都给你捋清楚，收藏这篇，下次直接抄。

MyBatis-Plus 分页插件与字段自动填充：两行配置告别 CRUD 重复劳动

MyBatis-Plus 分页插件怎么配？审计字段怎么自动填充？本文用用户管理示例，两行配置搞定分页查询与创建/更新时间自动赋值，告别 CRUD 重复劳动。

数据库

开发工具

后端

MyBatis-Plus分页插件与字段自动填充配置教程：通过PaginationInnerInterceptor实现count+limit自动拼接，MetaObjectHandler配合@TableField注解自动填充create_time/update_time。附带分页失效与填充不生效的踩坑解决方案，助力开发者减少CRUD模板代码。

代码解释

MySQL

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

MyBatis-Plus分页插件与字段自动填充配置教程：通过PaginationInnerInterceptor实现count+limit自动拼接，MetaObjectHandler配合@TableField注解自动填充create_time/update_time。附带分页失效与填充不生效的踩坑解决方案，助力开发者减...

MyBatis-Plus 分页插件与字段自动填充：两行配置告别 CRUD 重复劳动-腾讯云开发者社区-腾讯云

MyBatis-Plus 分页插件与字段自动填充：两行配置告别 CRUD 重复劳动

MyBatis-Plus 分页插件与字段自动填充：两行配置告别 CRUD 重复劳动

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐