✦ 本站观点： Mybatis以轻量级著称，SQL映射配置仅占代码5%体积，却实现90%持久层逻辑。其核心在于动态代理与反射，将Java对象与SQL无缝对接，兼顾灵活性与性能，是中小项目首选ORM框架。
MyBatis 原理 深入 解析 ：从入门到精通的底层逻辑
在 Java 企业级开发中，MyBatis 作为持久层框架的“半自动” ORM（对象关系映射）解决方案，凭借其灵活的 SQL 控制和出色的性能表现，长期占据着主流地位。不过，很多的开发者停留在“配置 XML 即可运行”的采用层面，对其内部运作机制缺乏深入 理解。
这篇文章将深入 剖析 MyBatis 原理 ，从配置加载、SQL 解析 、执行流程到缓存机制，层层递进，帮助你构建完整的知识体系。
MyBatis 核心架构概览
MyBatis 的设计哲学是“让程序员掌控 SQL”，其核心架构可概括为以下几个关键组件：
1. Configuration：全局配置中心，存储所有配置信息。
```mermaid
启动流程：从 XML 到内存对象
MyBatis 的启动过程本质上是一个配置解析 与对象初始化的过程。
解析配置文件
当调用 `SqlSessionFactoryBuilder.build()` 时，MyBatis 会读取 `
mybatis -config.xml` 和 Mapper XML 文件。
XML 解析：使用 DOM 或 SAX 解析器读取 XML 内容。
配置封装将 XML 中的节点（如 ``, ``, `` 等）转换为 Java 对象，存入 `Configuration` 对象中。
构建 SqlSessionFactory
解析完成后，`Configuration` 对象被封装进 `DefaultSqlSessionFactory`。此时，MyBatis 完成了所有静态配置的加载。
✦ 关键提示： 这篇文章深入解析 MyBatis 底层逻辑，涵盖配置加载、SQL 解析、执行流程及缓存机制。通过剖析 Configuration、Executor 等核心组件，帮助开发者从入门走向精通，构建完整知识体系。
创建 SqlSession
每次调用 `openSession()`，都会创建一个新的 `DefaultSqlSession` 实例。它持有 `Executor` 实例，而 `Executor` 是真正执行 SQL 的入口。
关键点：`SqlSession` 不是线程安全的，因此建议在方法内部创建和关闭，或通过 `ThreadLocal` 在 Spring 中管理。
核心执行流程：SQL 如何被执行？
这是 MyBatis 最核心的部分，以 `selectOne` 为例，其执行链路如下：
步骤 1：获取 Mapper 代理对象
当调用 `mapper.selectUser(1)` 时，调用的是 JDK 动态代理生成的代理类 `MapperProxy`。
`MapperProxy` 拦截方法调用。
根据方法名和参数，从 `MapperRegistry` 中获取对应的 `MappedStatement` 对象。
步骤 2：MappedStatement 的作用
`MappedStatement` 是 MyBatis 数据结构，它封装了：
SQL 语句（SQL Source）
参数映射规则（ParameterMap）
结果映射规则（ResultMap）
缓存配置（Cache）
步骤 3：Executor 调度执行
`SqlSession` 将请求委托给 `Executor`。MyBatis 默认使用 `SimpleExecutor`，但也可配置为 `ReuseExecutor` 或 `BatchExecutor`。
步骤 4：StatementHandler 预编译 SQL
`Executor` 调用 `StatementHandler` 的 `prepare()` 方法：
1. SQL 解析：经过 `SQLSource` 将动态 SQL（如 `
`, ``）解析为的静态 SQL 字符串。
2. 预编译：通过 JDBC `Connection.prepareStatement()` 生成 `PreparedStatement`。
3. 参数设置：`ParameterHandler` 遍历参数映射，将 Java 对象值设置到 `PreparedStatement` 的占位符中。
步骤 5：执行 SQL 并处理结果
1. 执行：调用 `PreparedStatement.execute()` 执行 SQL。
2. 结果映射：`ResultSetHandler` 遍历 `ResultSet`，根据 `ResultMap` 将每一行数据映射为 Java 对象。
3. 缓存存储：倘若配置了缓存，将结果存入二级缓存。
动态 SQL 原理 ：MyBatis 的“智能”之处
MyBatis 的动态 SQL 是其区别于其他 ORM 框架的重要特性。其核心在于 OGNL（Object-Graph Navigation Language） 表达式引擎和 SQL 片段复用。
✦ 关键提示： MyBatis通过`openSession`创建非线程安全的`SqlSession`执行SQL。以`selectOne`为例，JDK动态代理拦截调用，由`MapperProxy`从注册中心获取`MappedStatement`，封装SQL及参数映射，最终驱动`Executor`完成执行。
工作流程：
1. 解析阶段：MyBatis 解析 XML 中的 ``, ``, `` 等标签。
2. 生成 OGNL 表达式：将条件表达式转换为 OGNL 表达式树。
3. 运行时评估：在执行 SQL 前，根据传入的参数对象，评估 OGNL 表达式，决定哪些 SQL 片段需要拼接。
4. SQL 生成：拼接成完整的静态 SQL 语句。
示例：
```xml
SELECT FROM users
AND name = #{name}
AND age = #{age}
```
若 `name="Alice"`, `age=25`， SQL 为：`SELECT FROM users WHERE name = 'Alice' AND age = 25`
若 `name` 为 null，`` 标签被忽略，`` 标签自动去除多余的 `AND`。
缓存机制：提升性能
MyBatis 提供了两级缓存机制，合理配置可显著提升查询性能。
缓存级别
作用域
说明
默认开启
一级缓存
SqlSession
同一 SqlSession 内，相同 SQL 查询直接返回缓存结果。SqlSession 关闭或执行增删改后清空。
✅ 是
二级缓存
Mapper Namespace
跨 SqlSession 共享，基于 Namespace 隔离。需手动配置，并完成 `Serializable` 接口。
❌ 否
一级缓存失效场景：
1. 执行了增、删、改操作（即使 SQL 相同）。
2. 手动调用了 `sqlSession.clearCache()`。
3. 使用了不同的 `SqlSession` 实例。
二级缓存注意事项：
仅适用于读多写少的场景。
需确保实体类实现 `Serializable` 接口。
在分布式环境中，建议使用 Redis 等外部缓存替代二级缓存，避免数据不一致问题。
插件机制：MyBatis 的扩展性
MyBatis 提供了强大的插件机制，允许开发者在四大核心对象（`Executor`, `StatementHandler`, `ParameterHandler`, `ResultSetHandler`）的执行过程中进行拦截。
拦截器接口：
```java
public interface Interceptor {
Object intercept(Invocation invocation) throws Throwable;
Object plugin(Object target);
void setProperties(Properties properties);
}
```
✦ 关键提示： MyBatis动态SQL经解析、OGNL转换及运行时评估，智能拼接SQL以优化查询。配合两级缓存机制，有效减少数据库交互，显著提升系统整体性能与响应速度。
典型应用场景：
1. 分页插件（如 PageHelper）：拦截 `StatementHandler`，在 SQL 执行前修改 SQL，添加 `LIMIT` 子句。
2. 性能监控：拦截 `Executor`，记录 SQL 执行时间。
3. 数据权限过滤：拦截 `ParameterHandler`，自动追加租户 ID 或部门 ID 条件。
插件原理：
MyBatis 使用 JDK 动态代理 对四大核心对象开展包装。当调用目标方法时，实际调用的是代理对象，代理对象再调用 `Interceptor.intercept()` 方法，从而实现无侵入式增强。
最佳实践与常见问题
避免 N+1 查询问题
问题：在嵌套结果映射中，每次查询主表都触发一次子表查询，导致数据库压力剧增。
解决：使用 `` 或 `` 时，指定 `fetchType="lazy"`（延迟加载）或改为关联查询（JOIN）。
合理使用批量操作
对于大量数据插入，使用 `BatchExecutor`：
```java
SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH);
for (int i = 0; i < 1000; i++) {
userMapper.insert(user);
}
session.commit();
```
参数传递规范
多个参数时，使用 `@Param` 注解明确命名，避免使用 `arg0`, `arg1` 等默认命名，提高可读性和维护性。
结果映射优化
尽量采用 `ResultMap` 而非 `ResultType`，特别是在字段名与属性名不一致时。
对于复杂嵌套对象，考虑采用嵌套查询或关联查询，避免一次性加载过多数据。
MyBatis 的强大不仅在于其简单的 API，更在于其灵活的设计理念和可扩展的架构。通过深入理解其配置加载、SQL 执行、缓存机制和插件系统，开发者能够更高效地解决性能瓶颈，构建更健壮的企业级应用。
在实际项目中，建议结合 Spring 生态使用 MyBatis-Spring-Boot-Starter，并辅以 PageHelper、MyBatis-Plus 等工具库，以进一步提升开发效率。，始终关注 SQL 执行计划，确保数据访问层的性能最优。
✦ 文章认为： 这篇文章深入解析MyBatis底层逻辑，涵盖配置加载、SQL解析、执行流程及缓存机制。通过剖析Configuration、Executor等核心组件，揭示从XML解析到JDBC执行的完整链路，帮助开发者突破“配置即可”的局限，构建从入门到精通的完整知识体系，掌握半自动ORM框架的核心原理。
