夜雨聆风学习资料网

ARTICLE · 1397460

02 Mybatis-Plus源码剖析:启动主线从 @SpringBootApplication 到 MP 就绪

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 原生逻辑,只在它已有的扩展点上挂钩

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料