跳转到内容
Max / Knowledge

MyBatis-Plus

Difficulty
Advanced
Status
Stable
Last reviewed
2026年8月

MyBatis-Plus 不替换 MyBatis 的执行器，而是在配置、Mapper 元数据、SQL 注入和拦截器层增加约定式能力。读它的关键是看“一个实体如何变成可执行的 MappedStatement”。

本册问题地图

Section titled “本册问题地图”

MyBatis-Plus 的能力可以按“启动期生成，执行期拦截”来读：

  1. 通用 CRUD 从哪里来？ 启动期读取实体的表元数据，并把通用方法注入为 MappedStatement；运行时不是临时拼接一段神奇 SQL。
  2. TableInfo 为什么要缓存？ 表名、主键和字段映射在启动后基本稳定，缓存能避免每次调用重复反射，但动态表结构场景要特别谨慎。
  3. Wrapper 如何保持安全？ 条件被组织为参数化片段，值与 SQL 结构分离；把用户输入直接当列名或片段仍可能破坏安全边界。
  4. 拦截器顺序为什么重要？ 分页、租户、逻辑删除等插件会连续改写 SQL；排查必须看原始 SQL、插件顺序和最终 BoundSql。
  5. 增强的边界是什么？ 通用能力减少样板代码，却不能替业务决定复杂查询的索引、锁粒度和事务语义。

版本快照

Section titled “版本快照”
项 值
仓库 baomidou/mybatis-plus
本地路径 E:\source\java\storage\mybatis-plus
分支 3.0
Commit bf67d907478c724120bf76292da54abf9e73c2b3（2026-08-03）
最近 tag v3.5.17

本册坐标均基于上述 commit；上游演进后行号可能漂移。

模块地图

Section titled “模块地图”
模块 职责 关键类
core MyBatis 配置、元数据和基础 Mapper MybatisConfiguration、TableInfoHelper、BaseMapper
extension Wrapper、Service、插件和 SQL 注入扩展 AbstractWrapper、MybatisPlusInterceptor
jsqlparser 分页、租户、数据权限等 SQL 改写 PaginationInnerInterceptor
spring SqlSessionFactory 与 Spring 生命周期整合 MybatisSqlSessionFactoryBean、ServiceImpl
generator 根据表结构生成实体、Mapper 和 Service generator module

读码入口

Section titled “读码入口”
  1. TableInfoHelper#initTableInfo，看实体和注解如何变成表元数据。
  2. AbstractMethod#inject，看通用 CRUD 如何注入 MappedStatement。
  3. BaseMapper，看运行时如何调用注入的方法。
  4. AbstractWrapper，看条件表达式如何构造成 SQL 片段和参数。
  5. MybatisPlusInterceptor 与 inner interceptor，看分页、乐观锁、租户等如何插入执行链。

本册目录

Section titled “本册目录”

横向对照

Section titled “横向对照”
对象 对照点
MyBatis MyBatis-Plus 在原生 Configuration、Mapper 和 Interceptor 之上做增强
ShardingSphere MyBatis-Plus 主要改写单条 SQL，ShardingSphere 进一步做路由和分片执行
Druid 都使用 SQL 解析/拦截增强，但 Druid 更偏 JDBC 代理与观测
Section titled “Related”