ARTICLE · 1397460
02 Mybatis-Plus源码剖析:启动主线从 @SpringBootApplication 到 MP 就绪
开篇一句话
整个启动过程集中在 MybatisSqlSessionFactoryBean.buildSqlSessionFactory() 这一个方法里——它在 MyBatis 原生 FactoryBean 的基础上,多加了「注入 GlobalConfig」和「调用 SqlInjector.injectAll()」两步。
调用链总览
从你写的 @SpringBootApplication 到 MP 就绪,关键节点:
SpringApplication.run()└── SpringFactoriesLoader.loadFactoryNames()└── 找到 MybatisPlusAutoConfiguration(key=EnableAutoConfiguration)└── MybatisPlusAutoConfiguration.sqlSessionFactory()└── new MybatisSqlSessionFactoryBean() ← 替换了原生 SqlSessionFactoryBean└── bean.setGlobalConfig(globalConfig()) ← MP 特有:注入 GlobalConfig└── bean.getObject()└── MybatisSqlSessionFactoryBean.buildSqlSessionFactory()├── ★ 创建 MybatisConfiguration(继承 MyBatis Configuration)├── ★ sqlInjector.injectAll(...) ← CRUD 方法全部在这里注入├── ★ 设置 PluginContainer ← 注册 MybatisPlusInterceptor└── super.build() → 原生 Executor / StatementHandler / Mapper 扫描
这整条链路里,MP 只"插"了 3 个点:创建 MybatisConfiguration、调用 injectAll、注册拦截器。其他全是 MyBatis 原生逻辑。
类继承关系图
┌─────────────────────────────────────────────────┐│ SqlSessionFactoryBean(MyBatis 原生) ││ 核心方法:buildSqlSessionFactory() │└──────────────┬──────────────────────────────────┘│ extends▼┌─────────────────────────────────────────────────┐│ MybatisSqlSessionFactoryBean(MP) ││ 新增:globalConfig 字段 ││ 重写:buildSqlSessionFactory() │└──────────────┬──────────────────────────────────┘│ 使用▼┌──────────────────┐ ┌────────────────────────┐│ GlobalConfig │ │ DefaultSqlInjector ││ 全局配置(表前缀、 │ │ injectAll() → 注入 CRUD ││ 逻辑删除字段等) │ │ │└──────────────────┘ └────────────────────────┘
MybatisSqlSessionFactoryBean.buildSqlSessionFactory() 逐行走读这是 MP 启动时最关键的一个方法,约 150 行。重点看它比原生多做了什么:
// MybatisSqlSessionFactoryBean.java
protected SqlSessionFactory buildSqlSessionFactory() throws IOException {// ====== 第 1 步:创建 Configuration ======// ★ 替换点 1:用 MybatisConfiguration 代替 MyBatis 原生 Configuration// MybatisConfiguration extends Configuration,加了 MP 特有字段(globalConfig 等)MybatisConfiguration configuration = this.configuration != null? this.configuration : new MybatisConfiguration();// ====== 第 2 步:注入 GlobalConfig ======// ★ 替换点 2:把全局配置存到 Configuration 中GlobalConfig globalConfig = this.globalConfig;if (globalConfig != null) {GlobalConfigUtils.setGlobalConfig(configuration, globalConfig);}// ====== 第 3 步:原生 Mapper 扫描(略) ======// 这部分和 MyBatis 原生 SqlSessionFactoryBean 完全一样:// 解析 mybatis-config.xml、注册 XML 里的 Mapper、处理 typeHandler 等...// ====== 第 4 步:★ 调用 SqlInjector ======// ★ 替换点 3:这是 MP 自动 CRUD 的核心!// 在所有 Mapper 接口注册完成后,注入额外的 CRUD 方法TableInfoHelper.initTableInfo(generator, globalConfig, mapperClass);// TableInfoHelper 用反射解析实体类的 @TableName / @TableId / @TableField 注解// 生成 TableInfo 对象(表名、主键、字段列表)// ★★ 关键调用:SqlInjector.injectAll()// 对每个扫描到的 Mapper 接口,注入 17 个 CRUD 方法String injectorName = configuration.getGlobalConfig().getSqlInjector();ISqlInjector injector = BeanUtils.instantiateClass(injectorName);injector.injectAll(configuration);// ↑ 这个方法内部会:// 1. 遍历 configuration.mapperRegistry.getMappers() 拿到所有 Mapper 接口// 2. 对每个 Mapper,遍历 17 个 AbstractMethod 子类// 3. 每个 AbstractMethod 拼 SQL,注册 MappedStatement 到 configuration// ====== 第 5 步:注册插件 ======// 把 MybatisPlusInterceptor 添加到 MyBatis 原生的 pluginContainer// MyBatis 原生 Interceptor 机制:Plugin.wrap() 创建动态代理// MybatisPlusInterceptor 实现 MyBatis Interceptor 接口// 但它内部又维护了一个 InnerInterceptor 链// 运行时 MyBatis 先调 MybatisPlusInterceptor.intercept()// MybatisPlusInterceptor 再遍历 InnerInterceptor 链逐个调用// ====== 第 6 步:super.build() ======// 剩下的全部是 MyBatis 原生逻辑,创建 SqlSessionFactory 并返回return super.buildSqlSessionFactory();}
★ 总结:buildSqlSessionFactory 的 MP特有逻辑只有两处——injectAll(注入方法)和 plugin 注册。其余完全复用 MyBatis 原生。
什么必须用MybatisSqlSessionFactoryBean替换原生?
如果不替换,只用原生 SqlSessionFactoryBean,会有三个问题:
1. 原生 Configuration 里没有 globalConfig 字段 → SqlInjector 和插件拿不到逻辑删除字段、表前缀等配置
2. 原生 FactoryBean 不会调用 injectAll() → BaseMapper 的 17 个方法全部缺失
3. 原生 FactoryBean 不知道 MP 的 InnerInterceptor 体系 → 插件不生效
所以 MybatisPlusAutoConfiguration 必须显式创建 MybatisSqlSessionFactoryBean,不能依赖 Spring Boot 的自动推断。
GlobalConfig 里存了什么
GlobalConfig 是一个 POJO,主要字段:
• String tablePrefix 表名前缀(如 "t_")
• String capitalMode 驼峰模式
• String logicDeleteField 逻辑删除字段名(如 "deleted")
• String logicDeleteValue 逻辑删除时设置的值(如 "1")
• String logicNotDeleteValue 未删除时的值(如 "0")
• String sqlInjector SqlInjector 实现类全限定名
这些值最终通过 GlobalConfigUtils 工具类挂到 MybatisConfiguration 上,插件和注入器通过 GlobalConfigUtils.getGlobalConfig(configuration) 随时取到。
📌 记忆卡片
·buildSqlSessionFactory() 是 MP 启动的心脏
·3 个替换点:MybatisConfiguration、injectAll()、plugin 注册
·injectAll() 内部遍历 Mapper → 遍历 17 个 AbstractMethod → 注册 MappedStatement
·GlobalConfig 存放表前缀、逻辑删除、SqlInjector 等全局配置
·MP 不修改 MyBatis 原生逻辑,只在它已有的扩展点上挂钩















































































