ARTICLE · 1392302
01 Mybatis-Plus源码剖析:源码阅读方法论
开篇一句话
读 MP 源码不需要通读全部类——抓住两个核心机制就能串联全部:SqlInjector(启动时注入)+ InnerInterceptor(运行时拦截)。
源码获取
GitHub 地址:github.com/baomidou/mybatis-plus
推荐阅读版本:3.5.7(最新稳定版,API 较 3.4.x 有少量变化)
导入 IDE:git clone 后用 Gradle 打开根目录即可,核心模块是 mybatis-plus-core。
模块速览:
mybatis-plus-core/ ← 核心:SqlInjector、Interceptor、GlobalConfig
mybatis-plus-extension/ ← 扩展:BaseMapper、IService、ServiceImpl
mybatis-plus-generator/ ← 代码生成器(非核心)
mybatis-plus-jsqlparser/ ← 基于 JSqlParser 的 SQL 改写工具
mybatis-plus-spring-boot3-starter/ ← Boot3 自动配置(核心类 MybatisPlusAutoConfiguration 在这里)
必读类清单(按依赖顺序)
第 1 层(入口):
com.baomidou.mybatisplus.autoconfigure.MybatisPlusAutoConfigurationcom.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean
第 2 层(核心机制):
com.baomidou.mybatisplus.core.injector.AbstractSqlInjector → DefaultSqlInjectorcom.baomidou.mybatisplus.core.injector.methods.AbstractMethodcom.baomidou.mybatisplus.core.plugins.MybatisPlusInterceptorcom.baomidou.mybatisplus.core.plugins.InterceptorIgnore
第 3 层(具体插件):
com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptorcom.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptorcom.baomidou.mybatisplus.extension.plugins.inner.LogicDeleteInnerInterceptorcom.baomidou.mybatisplus.extension.plugins.inner.TenantLineInnerInterceptor
第 4 层(工具):
com.baomidou.mybatisplus.core.toolkit.GlobalConfigUtilscom.baomidou.mybatisplus.core.metadata.TableInfoHelper → TableInfocom.baomidou.mybatisplus.extension.plugins.pagination.Page
MP vs MyBatis 关系图
┌──────────────────────────────────────────────────────┐│ MyBatis-Plus 增强层 ││ SqlInjector(启动时注入 MappedStatement) ││ InnerInterceptor 链(运行时在 MyBatis 内部拦截 SQL) ││ Wrapper 条件构造器(帮你拼 WHERE 子句) │└───────────────┬──────────────────────────────────────┘│ 扩展(不改原生源码)
┌──────────────────────────────────────────────────────┐│ MyBatis 原生层(不变) ││ Configuration ─ 注册/管理 MappedStatement ││ MappedStatement ─ SQL + 参数映射 + ResultMap ││ SqlSession ─ 执行入口 ││ Executor ─ SQL 执行(BaseExecutor / CachingExecutor)││ StatementHandler ─ JDBC Statement 封装 ││ Interceptor ─ 原生拦截器链(Plugin.wrap() 动态代理)│└──────────────────────────────────────────────────────┘
关键结论:MP 所有增强都基于 MyBatis 已有的扩展点——Configuration 注册 MappedStatement 和 Interceptor 机制。MP 没有侵入式修改 MyBatis 源码。
阅读路径建议
推荐顺序(约 6 小时读完核心):
1. 10 分钟:MybatisPlusAutoConfiguration(L200-L400 行,看 Bean 定义)2. 40 分钟:MybatisSqlSessionFactoryBean.buildSqlSessionFactory() 找到 sqlInjector.injectAll() 的调用点3. 1 小时:AbstractSqlInjector.injectAll() + DefaultSqlInjector.getMethodList()+ AbstractMethod.injectMappedStatement()4. 30 分钟:TableInfoHelper → 了解实体类注解怎么解析成表结构5. 1 小时:MybatisPlusInterceptor 注册 + InnerInterceptor 接口 7 个方法签名6. 2 小时:PaginationInnerInterceptor.beforeQuery() 完整源码(JSqlParser SQL 改写)7. 40 分钟:OptimisticLockerInnerInterceptor + LogicDeleteInnerInterceptor跳过:IService/ServiceImpl(只是 BaseMapper 的业务封装,无新机制)、CodeGenerator(和运行时无关)
📌 记忆卡片
MP 核心 = SqlInjector(启动注入) + InnerInterceptor(运行拦截)
MP 没有改 MyBatis 源码,全部基于已有扩展点
必读 4 个核心类:MybatisPlusAutoConfiguration / MybatisSqlSessionFactoryBean / AbstractSqlInjector / MybatisPlusInterceptor
源码主线:FactoryBean.build() → injectAll() → registerPlugins()















































































