> Spring 系列 · 第 9 篇(持久层进阶)
>适用读者 :会写 Java 和简单 SQL,用过 Spring Boot,第一次接触 MyBatis-Plus。最好先读过 MyBatis 持久层实战(./Spring-MyBatis持久层实战指南.md),不读也能跟着本文把示例跑起来。
>技术环境 :Java 17(本文 `mvn test` 实际跑在 Java 21)· Spring Boot 3.4.1 · MyBatis-Plus 3.5.18 · 示例面向 MySQL 8
>示例项目:mybatis-plus-user-demo(./mybatis-plus-user-demo/)
提示:写完文章后,目录可以自动生成,如何生成可参考右边的帮助文档
文章目录
[- 前言:第三张表开始,你会烦(#前言第三张表开始你会烦)
- 一、从重复劳动开始:为什么需要 MyBatis-Plus(#一从重复劳动开始为什么需要-mybatis-plus)
- 二、搭好一个能运行的示例(#二搭好一个能运行的示例)
- 三、看懂实体类和数据库表如何对应(#三看懂实体类和数据库表如何对应)
- 四、用少量代码完成基础 CRUD(#四用少量代码完成基础-crud)
- 五、把查询条件写清楚(#五把查询条件写清楚)
- 六、分页与逻辑删除如何工作(#六分页与逻辑删除如何工作)
- 七、哪些地方不能只靠框架(#七哪些地方不能只靠框架)
- 八、检验自己是否真正理解(#八检验自己是否真正理解)](#前言第三张表开始你会烦) - 一、从重复劳动开始:为什么需要 MyBatis-Plus - 二、搭好一个能运行的示例 - 三、看懂实体类和数据库表如何对应 - 四、用少量代码完成基础 CRUD - 五、把查询条件写清楚 - 六、分页与逻辑删除如何工作 - 七、哪些地方不能只靠框架 - 八、检验自己是否真正理解)
前言:第三张表开始,你会烦
假设系统里有一张用户表。新增、按编号查询、修改、删除,四条 SQL,外加一个 Mapper 接口。第二天来一张部门表,又是四条。第三天来一张角色表,你开始复制粘贴,只改表名。
这些 SQL 长得几乎一样,错却容易出在「复制完忘了改某一列」。MyBatis-Plus 要解决的就是这种单表、形状固定的重复劳动。它不负责替你设计表,也不负责把三张表 JOIN 出一份报表。
> 一句话:MyBatis 是「你写 SQL,它帮你执行并映射成对象」;MyBatis-Plus 是在这之上,把「按主键增删改查」这种每张表都差不多的 SQL,提前写好了。
读完后你应该能做到:
-
说清楚 MyBatis、MyBatis-Plus 和数据库各管哪一段;
-
知道它省掉的是哪一类代码,以及它不该承包的查询;
-
独立做出用户模块的增删改查、条件查询和分页;
-
认出逻辑删除、空值更新、手写 SQL 这三处最容易想错的地方。
验证范围先说清楚。 示例项目的 `mvn test` 用 H2 的 MySQL 兼容模式跑过,下面引用的 SQL 来自这次测试的日志。项目里的 MySQL 地址、账号和 `sql/schema.sql` 是给本机 MySQL 8 准备的**,我没有连上真实 MySQL 再跑一遍**。接口代码没有用 HTTP 客户端打过,文中的 JSON 是按 Service 测试结果整理的。
提示:以下是本篇文章正文内容,下面案例可供参考
一、从重复劳动开始:为什么需要 MyBatis-Plus
1.1 同一条【按编号查询】,两种写法差在哪
用MyBatis 做【按id查用户】,你至少要准备接口和SQL:
java
public interface SysUserMapper {
SysUser selectById(Long id);
}
XML
<select id="selectById" resultType="com.example.userdemo.entity.SysUser">
SELECT id, name, age, email, deleted
FROM sys_user
WHERE id = #{id}
</select>
插入、更新、删除这组固定还要再写一份。表字段一改,XML里的列清单还要改。
MyBatis-Plus把这组固定动作做进了Base Mapper。你的接口变成了:
java
@Mapper
public interface SysUserMapper extends BaseMapper<SysUser> {
}
调用 `sysUserMapper.selectById(1L)` 时,框架按实体上的注解拼出 SQL,再交给 MyBatis 执行。测试日志里按主键查询的语句是:
SELECT id,name,age,email,deleted FROM sys_user WHERE id=? AND deleted=0
`?` 是预编译参数,不是把数字拼进 SQL 字符串。后面的 `deleted=0` 不是我们在 Java 里手写的,是逻辑删除加上的,第六节再拆。
你可能会问:那我是不是不用学 MyBatis 了?
不用学 XML 的语法细节,也要知道这句话最终还是 MyBatis 的 `SqlSession` 在执行。日志里的 `Preparing` / `Parameters` 就是 MyBatis 打出来的。Plus 没换数据库驱动,也没换事务管理器。
1.2 它适合省什么,不适合省什么
适合交给它的,是【一张表、条件说得清】的操作;按主键取一行、按字段过滤、排序、分页、按主键改几个非空字段。
不适合一开始就交给它的,是多表关联、分组统计、数据库方言函数、以及【这个字段就算是null 也必须写进UPDATE】这类要精确控制SET子句的语句。这些在第七节用手写SQL接回来。
1.3 不要把它和JPA 画等号
生活里可以把它想成连锁店的标准点菜单:
红烧肉、米饭、例汤,每家店都有,总部印好了,特色菜仍然有这家店由这家店自己写在黑板上。
类比的边界:点菜单不会在你改了菜品数量之后又,自己偷偷再下一单。JPA/Hibernate会跟踪实体状态,事务提交时可能把你改过的字段自动UPDATE回去。MyBatis-Plus不盯着对象。你调用`save`、`updateById`、`removeById`,它才发 SQL;方法返回之后,内存里的对象不会再和数据库保持同步。
所以它是MyBatis的增强工具,不是【另一个全自动ORM】。
二、搭好一个能运行的示例
2.1 版本锁死,不写「最新版」

3.5.9 之后有两处和旧教程不一样,本文按 3.5.18 的 jar 为准:
-
分页插件依赖的 SQL 解析器要另外 引入 `mybatis-plus-jsqlparser`,版本与 starter 相同。
-
`IService` / `ServiceImpl` 的包名是 `com.baomidou.mybatisplus.spring.service`。我在 `mybatis-plus-extension-3.5.18.jar` 里没有找到旧的 `extension.service.IService`。很多 2024 年以前的文章仍在教旧包名,照抄会编译失败。
Spring Boot 3 用 `mybatis-plus-spring-boot3-starter`。不要再引入 `mybatis-spring-boot-starter`,两套自动配置叠在一起容易打架。官方安装说明也写了这一点。
2.2 Maven 依赖
`mysql-connector-j` 的版本交给 Spring Boot 3.4.1 的 parent 管理,pom 里不手写。
XML
<properties>
<java.version>17</java.version>
<mybatis-plus.version>3.5.18</mybatis-plus.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-spring-boot3-starter</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-jsqlparser</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
</dependencies>
2.3 贯穿全文的表
文件在 `mybatis-plus-user-demo/sql/schema.sql`:
sql
CREATE DATABASE IF NOT EXISTS user_demo DEFAULT CHARACTER SET utf8mb4;
USE user_demo;
CREATE TABLE sys_user (
id BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键',
name VARCHAR(50) NOT NULL COMMENT '姓名',
age INT NULL COMMENT '年龄',
email VARCHAR(100) NULL COMMENT '邮箱',
deleted INT NOT NULL DEFAULT 0 COMMENT '逻辑删除:0 未删除,1 已删除',
PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
`deleted` 用 `INT`,不用 `TINYINT(1)`。MySQL 驱动默认可能把 `TINYINT(1)` 当成布尔值,和实体里的 `Integer` 对不上。这是驱动的映射规则,不是 Plus 的注解能改的。
2.4 配置和目录
java
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/user_demo?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
username: root
password: root
driver-class-name: com.mysql.cj.jdbc.Driver
mybatis-plus:
configuration:
map-underscore-to-camel-case: true
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
global-config:
db-config:
id-type: auto
logic-delete-field: deleted
logic-delete-value: 1
logic-not-delete-value: 0
mybatis-plus-user-demo
├── pom.xml
├── sql/schema.sql
└── src/main/java/com/example/userdemo
├── UserDemoApplication.java
├── config/MybatisPlusConfig.java
├── entity/SysUser.java
├── mapper/SysUserMapper.java
├── service/SysUserService.java
├── service/impl/SysUserServiceImpl.java
├── controller/SysUserController.java
└── dto/ UserSaveRequest、UserQuery、PageResult
启动类只要 `@SpringBootApplication`。Mapper 接口上的 `@Mapper` 会被 starter 扫到。Mapper 如果放在启动类的包外面,再加 `@MapperScan`。
三、看懂实体类和数据库表如何对应
3.1 四个注解各自回答一个问题
实体回答的是:这行数据在 Java 里长什么样,哪一列是主键,哪一列表示「已经删了」。
java
@TableName("sys_user")
public class SysUser {
@TableId(type = IdType.AUTO)
private Long id;
private String name;
private Integer age;
private String email;
@TableLogic(value = "0", delval = "1")
private Integer deleted;
// getName / setName 等访问器见示例项目。
// Lambda 表达式 SysUser::getName 依赖这些方法,不是依赖字段名本身。
}

主键策略先记两个就够。`AUTO` 是数据库自己编号,测试里三条数据的 id 是 1、2、3。`ASSIGN_ID` 是框架用雪花算法在 Java 里先算好一个长整型再插入。启动日志里出现过 `datacenterId` / `workerId`,那是雪花算法的初始化信息;本实体没有用它,插入语句里没有 id 列。
全局配置 `id-type: auto` 和字段上的 `@TableId(type = IdType.AUTO)` 说的是同一件事。字段注解更显眼,全局配置用来兜住那些没标注解的实体。
3.2 数据库里存了什么,框架替你做了什么
建表语句决定列、类型、默认值、自增。这些在 Java 进程没起来时就已经存在。
框架做的是另一半:
-
启动时根据实体注册「insert / selectById / updateById / deleteById」这些语句;
-
调用时把对象属性放进 `?`;
-
把结果集填回对象;
-
发现 `@TableLogic` 之后,查询和更新自动带上「还没删除」,删除改成改标记。
你可能会问:`save` 返回之后,`deleted` 为什么还是 null?**
测试里就是这样。插入语句是:
INSERT INTO sys_user ( name, age, email ) VALUES ( ?, ?, ? )
`deleted` 为 null,默认的 `NOT_NULL` 策略(3.5.18 的 `DbConfig` 构造方法把 insert、update、where 三个策略都设成了 `FieldStrategy.NOT_NULL`)会把它从列清单里拿掉,于是用上表的 `DEFAULT 0`。`save` 只把自增主键填回来,不会再发一条 SELECT 把默认值读回来。想看到 `deleted = 0`,要再 `getById`。
这就是「框架不是数据库」:默认值发生在库里,Java 对象不会自动刷新。
3.3 这些类怎么串起来

`BaseMapper<SysUser>` 里的 `T` 就是这张表对应的实体。换一张表,就换一个实体、再写一个 `extends BaseMapper<那张表的实体>`。通用方法跟着 `T` 走,不用复制。
`countActiveByAgeRange` 是我们自己加的方法,不在 `BaseMapper` 里。框架不会为它发明逻辑删除条件,SQL 全文要自己写。这是第七节的例子。
四、用少量代码完成基础 CRUD
4.1 一次按主键查询,中间经过谁
生活类比:你对前台说【查1号会员】。前台(Service)核对这个人还在不在;柜员(Mapper代理)拿出标准表格;表格生成器(Plus)把【1号】和【未注销】印进单据;邮局(MyBatis)寄给数据库;数据库回一封信,邮局拆开放进`SysUser`。
类比的边界:前台不会改单据上的SQL。SQL的形状在启动时就已经注册好了,这次调用只填参数。

零行时方法返回 `null`,不抛「找不到」的异常。示例里的 Controller 把 `null` 转成了「用户不存在」。这是我们写的业务反应,不是框架的默认行为。
4.2 新增、修改、删除各发什么 SQL
Service 里和数据库相关的四次调用是:
java
save(user); // INSERT,跳过值为 null 的字段
getById(id); // SELECT ... WHERE id=? AND deleted=0
updateById(patch); // UPDATE,SET 里只有非 null 字段
removeById(id); // 因为有 @TableLogic,实际是 UPDATE deleted=1
测试里把「林夏」改名为「林夏一」,年龄和邮箱传的是 null。日志只有:
UPDATE sys_user SET name=? WHERE id=? AND deleted=0
随后再查,年龄仍是 28,邮箱仍在。null 的意思是「这次别碰这列」,不是「把这列写成 NULL」。 想把邮箱清空,不能靠 `setEmail(null)` 再 `updateById`。那要写 `UpdateWrapper`,显式 `set` 成 null,并确认字段策略允许。本文的示例没有做「清空字段」。
删除的日志是:
UPDATE sys_user SET deleted=1 WHERE id=? AND deleted=0
然后再 `getById`,结果集行数是 0。用 `JdbcTemplate` 绕过框架去查同一行,`deleted` 仍是 1。行还在。
4.3 `IService` 是一层便利,不是必经之路
3.5.9 的变更说明里写过:通用能力抽到了 Repository,不再建议用 IService 把业务层和数据操作搅在一起。3.5.18 里这个接口还在,位置挪到了 `com.baomidou.mybatisplus.spring.service.IService`,它继承 `IRepository`。`ServiceImpl` 继承 `CrudRepository`,所以 `save`、`getById`、`page` 这些方法还在。
示例仍然用了它,因为你在现有项目里最常见到的就是这层。它做的事可以概括成:帮你注入 `BaseMapper`,并提供一批和 Mapper 同义的方法(`save` 对应 `insert`,`removeById` 对应 `deleteById`)。
Controller 只调 `SysUserService`。下面这些决定放在 `SysUserServiceImpl`,没有放进 Mapper:
-
姓名不能为空;
-
空白邮箱当成「没填」,不要写成空字符串;
-
页码小于 1 时按第 1 页,每页条数限制在 1 到 100;
-
条件是否拼进 WHERE,看参数有没有值。
Mapper 保持「怎么访问这张表」。业务规则换一张表就不成立,所以留在 Service。只做单表 CRUD、没有这些规则时,Controller 直接注入 Mapper 也能工作。多这一层是为了放规则,不是框架强迫的。
请求体用 `UserSaveRequest`,不直接收 `SysUser`。否则调用方可以在 JSON 里带上 `deleted`,虽然更新策略不一定会把它写进去,但没必要把这个字段暴露成入参。
五、把查询条件写清楚
5.1 字符串列名,和 Lambda 列名
两种写法都能描述「年龄大于等于、按 id 倒序」:
java
QueryWrapper<SysUser> byName = new QueryWrapper<SysUser>()
.like("name", "林")
.ge("age", 20)
.orderByDesc("id");
java
LambdaQueryWrapper<SysUser> byMethod = new LambdaQueryWrapper<SysUser>()
.like(SysUser::getName, "林")
.ge(SysUser::getAge, 20)
.orderByDesc(SysUser::getId);
示例项目走的是第二种。第一种能工作,但 `"name"` 只是字符串。你把属性改成 `username` 并改了列名,编译器不会提醒这行字符串。`SysUser::getName` 在改名时会编译失败,IDE 的「重命名」也能跟上。
Lambda 能做到这件事,是因为接口方法在字节码里留着名字 `getName`,框架去掉 `get`、再按驼峰转下划线得到列名。它不是在运行时扫描数据库表结构。列名和这个推导结果不一致时,仍然要 `@TableField`。
类比:字符串列名像在便签上写「第三排柜子」;方法引用像贴着柜子的正式标签,柜子改名时便签不会自己变。边界:便签写对了一样能找到柜子。Lambda 不是更安全的 SQL,只是列名和 Java 方法绑在一起,重构时更不容易留一处旧名字。
5.2 参数为空时,不要把条件加上
`like`、`eq`、`ge`、`le` 都有一个带布尔值的重载:第一个参数为 false,这个条件就不会出现在 SQL 里。
java
LambdaQueryWrapper<SysUser> wrapper = new LambdaQueryWrapper<>();
wrapper.like(StringUtils.hasText(query.getName()), SysUser::getName, query.getName())
.eq(StringUtils.hasText(query.getEmail()), SysUser::getEmail, query.getEmail())
.ge(query.getMinAge() != null, SysUser::getAge, query.getMinAge())
.le(query.getMaxAge() != null, SysUser::getAge, query.getMaxAge())
.orderByDesc(SysUser::getId);
测试只传了年龄 20 到 30,日志里的条件就是年龄,没有姓名:
SELECT COUNT(*) AS total FROM sys_user WHERE deleted = 0 AND (age >= ? AND age <= ?)
SELECT id,name,age,email,deleted FROM sys_user WHERE deleted=0 AND (age >= ? AND age <= ?) ORDER BY id DESC LIMIT ?
参数是 `20`、`30`,以及 `LIMIT` 后面的 `2`。姓名若也传了「林」,才会多一个 `LIKE`。空字符串用 `StringUtils.hasText` 挡掉,避免拼出 `name LIKE '%'` 这种把全表扫进来的条件。
常见误区: 自己先 `if` 再 `wrapper.like(...)`,和这个布尔重载是一回事。容易错的是写成 `like(name != null, ...)`,空字符串仍然会进去。
六、分页与逻辑删除如何工作
6.1 分页插件要自己注册
starter 不会自动分页。不注册 `PaginationInnerInterceptor` 时,你传入的 `Page` 不会变成 `LIMIT`,有机会把整表装进内存。3.5.9 起这个插件还依赖单独的 `mybatis-plus-jsqlparser`,只加 starter 会在真正分页时缺类。
java
@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new BlockAttackInnerInterceptor());
interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
return interceptor;
}
}
官方分页说明要求:多个内部插件时,分页放在最后。`BlockAttackInnerInterceptor` 用来拦住没有 WHERE 的更新和删除,也是这里显式 new 出来的,不是默认开启。
查询代码:
java
Page<SysUser> page = page(new Page<>(current, size), wrapper);
`current` 是第几页,从 1 开始。`size` 是每页条数。返回对象上:

当时库里有三个人:林夏 28 岁、周宁 35 岁、陈舟 22 岁。年龄 20 到 30 滤掉周宁,所以总数是 2。按 id 倒序,本页先是陈舟,再是已改名的林夏一。整理成接口会返回的 JSON:
java
{
"total": 2,
"current": 1,
"size": 2,
"pages": 1,
"records": [
{"id": 3, "name": "陈舟", "age": 22, "email": null, "deleted": 0},
{"id": 1, "name": "林夏一", "age": 28, "email": "linxia@example.com", "deleted": 0}
]
}
这是 Service 的返回值,不是一次真实 HTTP 调用的抓包。
对应请求如果走 Controller,是:
GET /api/users?current=1&size=2&minAge=20&maxAge=30
新增、查询、修改、删除分别是:
POST /api/users {"name":"林夏","age":28,"email":"linxia@example.com"}
GET /api/users/1
PUT /api/users/1 {"name":"林夏一"}
DELETE /api/users/1
`PUT` 只带姓名时,JSON 里没有的 `age`、`email` 会是 null,于是不会进入 SET,原值保留。这和测试里的更新是同一条规则。
分页会先查总数,再查一页。总数那条 SQL 由插件根据原查询改写,所以它和列表 SQL 的空格、括号不完全一样。测试里第一页的列表是 `LIMIT ?`,参数就是页大小。我没有再请求第 2 页,偏移不为 0 时日志里的 `LIMIT` 长什么样,以你打开日志看到的为准。MySQL 上分页越深,`LIMIT` 偏移越大,数据库往往仍要扫描被跳过的行。页码很大时,这是 SQL 的成本,不是把 `size` 调小就能消失的。
`DbType.MYSQL` 表示按 MySQL 的分页语法改写。测试库是 H2 的 MySQL 模式,所以它执行了这套语法。换数据库就要改这个枚举,否则生成的分页语句可能根本跑不了。
6.2 逻辑删除是改标记,不是 DROP 一行

物理删除是 `DELETE FROM sys_user WHERE id=?`,行从表里消失。逻辑删除是把 `deleted` 改成 1,普通查询都带 `deleted=0`,所以业务上看不到。
它适合「删错了还能在库里找到」的资料。它不适合当业务状态来用。官方逻辑删除说明里有一句很实在:如果你要经常把这些行查出来展示,就不要用逻辑删除,单独做一个状态字段。因为一旦标成逻辑删除,通用查询会故意看不见它。
配置可以写在 `@TableLogic` 上,也可以从 3.3.0 起只写全局的 `logic-delete-field`。示例两处都写了,而且值一致。只是为了对照,不是必须写两遍。两处写成不同的 0/1,就会和表里的数据对不上。
你可能会问:删掉之后,按邮箱再注册一个同名用户,会不会撞上旧行的唯一索引?
会。逻辑删除的行还占着唯一索引。本文这张表没有给 `email` 建唯一索引,所以测试看不出这个问题。真要「删除后允许再用同一个邮箱」,唯一索引得把删除标记设计进去,那已经超出这篇入门的范围。
七、哪些地方不能只靠框架
7.1 统计这种句子,自己写更清楚
「20 岁到 30 岁、还没删除的有多少人」用 `selectCount` 加条件也能做。下面这条放在 Mapper 上,是为了展示另一条路:SQL 由你负全责。
java
@Select("""
SELECT COUNT(*)
FROM sys_user
WHERE deleted = 0
AND age >= #{minAge}
AND age <= #{maxAge}
""")
Long countActiveByAgeRange(@Param("minAge") int minAge, @Param("maxAge") int maxAge);
测试参数 20 和 30,结果是 2,和分页的 `total` 一致。请注意 `WHERE deleted = 0` 是写死在字符串里的。换成 `BaseMapper` 的方法,框架会自动加;换成自己的 `@Select`,你写什么就执行什么。漏掉这句,已删除的人会被算进去。
联表、分组、子查询也是同样的道理。Wrapper 能拼的条件变长之后,读 SQL 的人还要把 Java 再翻译一遍。那种时候,一段放在注解或 XML 里的 SQL 更容易评审。
`#{}` 会变成 `?`。不要为了省事改成 `${}`,那是字符串替换,用户输入会进 SQL 正文。Wrapper 的 `apply` 如果拼接原始字符串,也是同一类风险。`eq` / `like` / `ge` 走的是参数绑定,测试日志里能看到 `?`。
7.2 四个容易想当然的点
1.代码少,不表示可以不看 SQL。 把 `log-impl` 设成标准输出,就是为了看见最终语句。逻辑删除、null 被省略、分页的 COUNT,都只在 SQL 里现形。
2.没有 WHERE 的更新或删除非常危险。 `BlockAttackInnerInterceptor` 的字节码里准备了两句拒绝理由:`Prohibition of full table deletion` 和 `Prohibition of table update operation`。测试对 `delete(new QueryWrapper<>())` 断言到了异常,并且日志里没有出现 `Preparing`,说明语句没送到数据库。逻辑删除会把 delete 改写成 update,因此你看到的可能是其中一句更新拦截。我没有在测试里打印异常原文,这里不指定唯一的那句英文。这个拦截器要自己注册;不注册的话,空条件删除会作用到所有未删除的行。
3.更新时的 null 不是 NULL。 第四节的日志已经证明。需要「写入 NULL」时单独处理,不要假设 `updateById` 会把没赋值的字段清空。
4.**分页的总数不是免费的。**每次分页至少两条 SQL。条件没有索引时,COUNT 和列表会一起慢。`size` 在 Service 里被限制到 100,避免一个请求拉走太多行;这是示例自己的限制,插件默认不会替你封顶。
八、检验自己是否真正理解

8.2 五道复述题
先自己答,再看后面的判断要点。
-
`removeById` 之后,表里还有没有这一行?`getById` 为什么返回 null?
-
为什么更倾向于 `SysUser::getEmail`,而不是 `"email"`?这是不是就防止了 SQL 注入?
-
只引入 starter、不注册 `PaginationInnerInterceptor`,`new Page<>(1, 10)` 会发生什么?
-
自己写的 `@Select` 会不会自动加上 `deleted = 0`?
-
`updateById` 时邮箱设为 null,数据库里的邮箱会被清空吗?
判断要点:
-
行还在,`deleted` 被改成 1。`getById` 的 SQL 带 `deleted=0`,所以返回 null。用不经框架的 SQL 仍能读到这行。
-
方法引用在改名时能编译失败,字符串不会。防注入靠的是 `?` 占位,两种 Wrapper 的 `eq` / `like` 都用占位。方法引用解决的是重构,不是注入。
-
插件不会生效,语句里不会按页截断。具体会不会把很多行查回来,取决于你有没有别的条件。分页插件和 `mybatis-plus-jsqlparser` 都要自己加上。
-
不会。自动追加只发生在框架生成的方法上。手写 SQL 要自己写删除条件。
-
不会。3.5.18 默认更新策略是 `NOT_NULL`,null 字段不进入 SET。测试里的语句只有 `SET name=?`。
8.3 做完才算会
在示例上加一个查询:**按姓名模糊匹配,并且可选地按年龄区间分页**。本文的 `pageUsers` 已经包含姓名和年龄。请你改一处它还没做的事,并写出你期望的 SQL:
给 `SysUserMapper` 增加一个方法,查出**已经逻辑删除**、且邮箱等于某个参数的用户。然后说明:
-
为什么不能用 `getById` 或普通的 `LambdaQueryWrapper` 完成;
-
SQL 里应不应该再写 `deleted = 0`;
-
参数为什么必须用 `#{}`。
判断要点:通用查询会强制「未删除」,所以看不见这些行。这条手写 SQL 要写 `deleted = 1`。邮箱用 `#{email}`,不要拼接进字符串。
总结
MyBatis-Plus 把「每张单表都要抄一遍的增删改查」收成了 `BaseMapper`。数据库仍执行 SQL,MyBatis 仍负责绑定参数和映射结果,Plus 负责把固定句式和逻辑删除、分页这些加工补上。
下次你觉得「框架怎么没按我想的更新」,先看日志里的 `Preparing`。那一行比任何注解的名字都接近真相:哪一列被省略了,哪一个条件被自动加上了,分页有没有真正带上 `LIMIT`。