如何在 Spring Boot 4 中集成 MyBatis-Plus，包括依赖配置、拦截器设置及基础特性。详细讲解了零 SQL CRUD、条件构造器、常用注解等核心功能，以及自动填充、逻辑删除和多数据源支持等增强能力。同时深入分析了分页、乐观锁、多租户等插件机制的执行流程，提供了自定义 SQL 的方法。最后对比了 MyBatis 一级与二级缓存的区别，阐述了 Mapper 代理及 Spring Boot 启动时的初始化加载流程，帮助开发者全面掌握 MyBatis-Plus 的使用与底层原理。
是一个 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。
添加 MyBatis-Plus 依赖：
<properties>
<mybatisplus.version>3.5.15</mybatisplus.version>
</properties>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-spring-boot4-starter</artifactId>
<version>${mybatisplus.version}</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-jsqlparser</artifactId>
<version>${mybatisplus.version}</version>
</dependency>
@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor();
// 数据权限
mybatisPlusInterceptor.addInnerInterceptor(new DataFilterInterceptor());
// 分页插件
mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());
// 乐观锁
mybatisPlusInterceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
// 防止全表更新与删除
mybatisPlusInterceptor.addInnerInterceptor(new BlockAttackInnerInterceptor());
return mybatisPlusInterceptor;
}
}
BaseMapper<T>，即可拥有 insert、selectById、updateById、deleteBatchIds 等 17 个常用方法。IService 和 ServiceImpl，封装了更多的业务逻辑方法（如 saveBatch 批量插入）。QueryWrapper（用于查询，支持 lambda 避免字段名写错）、UpdateWrapper（用于更新，支持链式设置 set 值）。LambdaQueryWrapper，利用方法引用（如 User::getName）来指定字段，编译期检查，防止 SQL 拼写错误。@TableName：指定表名（如果类名与表名不一致）。@TableId：指定主键策略（如 IdType.AUTO 自增，IdType.ASSIGN_ID 雪花算法）。@TableField：填充字段（如创建时间、更新时间自动填充 FieldFill.INSERT_UPDATE），或者逻辑删除字段 @TableLogic。MetaObjectHandler 接口，重写 insertFill 和 updateFill 方法，统一处理 create_time、update_time 等字段。delete 语句会自动转化为 UPDATE 语句（设置删除标记），查询时自动追加 WHERE deleted = 0 条件。@TableLogic 注解。IdentifierGenerator 主要用于生成数据库表的主键 ID。KeyGenerator 是 MyBatis 框架中的一个接口，用于在执行 SQL 语句时生成键值，通常用于生成自增主键或者在执行 INSERT 语句后获取新生成的 ID。dynamic-datasource-spring-boot-starter，支持 JDK 8 及以上版本。dynamic-datasource-spring-boot3-starter，要求 JDK 17 及以上。dynamic-datasource-spring-boot4-starter，要求 JDK 17 及以上。LIMIT）。MybatisPlusInterceptor，注入 PaginationInnerInterceptor。代码中使用 Page<T> 对象接收结果。version = newVersion 的条件为 version = oldVersion。update 和 delete 语句，确保这些操作不会无意中影响到整个数据表，从而保护数据的完整性和安全性。MyBatis-Plus（MP）插件的执行流程，本质上是基于 MyBatis 的插件（Plugin）机制实现的。MP 利用这一机制，在 MyBatis 的核心执行流程中'插入'自己的逻辑，从而实现分页、性能分析、SQL 注入防护等功能。
MybatisPlusInterceptor 是'包工头'，它实现了 MyBatis 的接口并拦下所有活；而 List<InnerInterceptor>是'工人'，实现具体的功能
| 组件层级 | 类/接口名称 | 职责 | 实现关系 |
|---|---|---|---|
| 顶层门面 | MybatisPlusInterceptor | 实现 MyBatis 原生 Interceptor，作为唯一入口，管理插件列表。 | 实现 org.apache.ibatis.plugin.Interceptor |
| 插件容器 | List<InnerInterceptor> | 存储具体的增强逻辑（如分页、乐观锁），由顶层门面调用。 | 内部持有 |
| 具体逻辑 | PaginationInnerInterceptor 等 | 实现具体的业务逻辑（如重写 SQL、计算耗时）。 | 实现 InnerInterceptor |
通过如下注解，可以实现自定义 SQL：
@Select: 查询@Insert: 插入@Update: 更新@Delete: 删除@Mapper
public interface UserMapper extends BaseMapper<User> {
// 简单查询
@Select("SELECT * FROM user WHERE email = #{email}")
User selectByEmail(@Param("email") String email);
// 复杂一点的条件查询
@Select("SELECT * FROM user WHERE status = #{status} AND age > #{minAge}")
List<User> selectByStatusAndAge(@Param("status") Integer status, @Param("minAge") Integer minAge);
}
# {} 和 ${} 的区别#{}：是预编译处理（PreparedStatement）。MyBatis 会将它替换为 ?，能有效防止 SQL 注入。${}：是字符串替换。直接将变量拼接到 SQL 中，存在注入风险，通常用于传入数据库表名或排序字段（ORDER BY）。SqlSession。在同一个会话中，相同的查询不再查数据库。默认开启。Namespace（多个会话间共享）。需要手动开启，且实体类必须实现序列化接口。INSERT, UPDATE, DELETE 操作都会刷新缓存。AS）。ResultMap 进行映射（最常用）。mapUnderscoreToCamelCase）。一级缓存建议保持默认（开启），而二级缓存通常不建议开启（默认也是关闭的），尤其是在复杂的业务或分布式系统中
一级缓存的实现参见：BaseExecutor、PerpetualCache
Executor（执行器）管理。在 BaseExecutor（所有执行器的基类）中，定义了本地缓存对象。SqlSession 每次创建都会生成一个新的 Executor，所以一级缓存是线程隔离的【参见 DefaultSqlSessionFactory】。二级缓存的实现参见：CachingExecutor、SynchronizedCache
当开启二级缓存后，MyBatis 会使用 CachingExecutor 包装原来的 Executor
装饰器模式： 二级缓存的实现非常优雅，PerpetualCache 是基础，通过 SynchronizedCache（同步）、LoggingCache（日志）、ScheduledCache（定时）、SerializedCache（序列化）、LruCache（回收策略）等装饰器层层包装，组合出最终需要的功能
| 特性 | 一级缓存 (Local) | 二级缓存 (Global) |
|---|---|---|
| 作用范围 | 单个 SqlSession 内 | 同一个 Mapper 命名空间内 |
| 数据共享 | 独享，不跨会话 | 共享，跨 SqlSession |
| 默认状态 | 开启 | 关闭 (需手动配置) |
| 生命周期 | 伴随 SqlSession 的创建与关闭 | 伴随 SqlSessionFactory 的生命周期 |
| 清空时机 | 增删改操作、close()、commit() | 对应 Mapper 的增删改操作、commit() |
| 缓存类型 | 建议配置 | 理由 | 适用场景 |
|---|---|---|---|
| 一级缓存 | 开启 (默认) | 安全、自动管理、提升单次会话性能 | 所有场景（无需干预） |
| 二级缓存 | 关闭 (默认) | 避免脏读、避免分布式不一致 | 复杂业务、分布式系统 |
| 二级缓存 | 开启 (需评估) | 需处理好序列化和跨表失效问题 | 单机应用、数据字典、纯读场景 |
一句话建议： 用好一级缓存，忘掉二级缓存，用 Redis 来做全局缓存
MybatisMapperProxy 是在 Spring 容器进行依赖注入（@Autowired）时，由 MapperProxyFactory 调用 getObject 方法实例化的。MybatisMapperProxy 会拿到一个 MapperMethod 实例。mapperMethod.execute(sqlSession, args)。MapperMethod 内部会根据 SQL 类型，调用 sqlSession.selectOne() 或 insert() 等方法。Executor 去 JDBC 层面执行 SQL。public class MapperRegistry {
private final Configuration config;
private final Map<Class<?>, MapperProxyFactory<?>> knownMappers = new ConcurrentHashMap<>();
public MapperRegistry(Configuration config) {
this.config = config;
}
public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
MapperProxyFactory<T> mapperProxyFactory = (MapperProxyFactory) this.knownMappers.get(type);
if (mapperProxyFactory == null) {
throw new BindingException("Type " + type + " is not known to the MapperRegistry.");
} else {
try {
return (T) mapperProxyFactory.newInstance(sqlSession);
} catch (Exception e) {
throw new BindingException("Error getting mapper instance. Cause: " + e, e);
}
}
}
}
MybatisAutoConfiguration -> MybatisSqlSessionFactoryBean -> SqlSessionFactoryAutoConfiguredMapperScannerRegistrar -> MapperScannerConfigurer -> ClassPathMapperScanner -> ClassPathBeanDefinitionScanner -> MapperFactoryBean@Autowired private UserMapper userMapper; 时。FactoryBean，于是调用 MapperFactoryBean.getObject()。MapperFactoryBean.getObject() 内部会调用 this.getSqlSession().getMapper(this.mapperInterface);。sqlSession.getMapper() 会委托给 (T)this.getConfiguration().getMapper(type, this);。Configuration 持有一个 this.mapperRegistry.getMapper(type, sqlSession)（注册中心）。MapperRegistry 里存着 Class -> MapperProxyFactory 的映射public class MapperRegistry {
private final Configuration config;
private final Map<Class<?>, MapperProxyFactory<?>> knownMappers = new ConcurrentHashMap<>();
public MapperRegistry(Configuration config) {
this.config = config;
}
public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
MapperProxyFactory<T> mapperProxyFactory = (MapperProxyFactory) this.knownMappers.get(type);
if (mapperProxyFactory == null) {
throw new BindingException("Type " + type + " is not known to the MapperRegistry.");
} else {
try {
return (T) mapperProxyFactory.newInstance(sqlSession);
} catch (Exception e) {
throw new BindingException("Error getting mapper instance. Cause: " + e, e);
}
}
}
}
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online