MyBatis 深度解析从 JDBC 之痛到优雅持久层框架——整体架构、执行全流程与核心模块剖析目录引言背景与目的整体架构概览全流程解析从获取连接到处结果集3.1 一条 SQL 的完整生命周期3.2 起点Configuration 与 SqlSessionFactory 的构建3.3 注册驱动 / 获取连接DataSource 的幕后工作3.4 解析 SQL动态 SQL 与 SqlSource 的诞生3.5 解析参数ParameterHandler 与类型映射3.6 执行核心Executor 的调度与一级缓存3.7 事务边界回滚/提交的决策机制3.8 结果映射ResultSetHandler 与复杂对象装配核心组件深度拆解4.1 Configuration全局配置中枢4.2 SqlSessionFactory SqlSession门面与生命周期4.3 Executor 家族Simple、Reuse、Batch4.4 MapperProxy基于动态代理的接口绑定4.5 MapperProxyFactory代理工厂的注册与生成4.6 Transaction事务抽象4.7 缓存机制一级缓存与二级缓存4.8 插件体系拦截器链与实战4.9 MappedStatement 与方法签名如何唯一定位 SQL基础支撑模块5.1 IO 与 VFS读取 Jar 内部及文件系统资源5.2 Parsing 模块XML 解析与动态 SQL5.3 Logging日志框架适配与 JDBC 异常封装5.4 Type 体系数据库类型与 Java 类型的桥梁5.5 Reflection通用反射工具包5.6 Exception异常层次体系5.7 Annotation 与 Lang注解驱动的配置总结与最佳实践1. 引言背景与目的当我们回想起早期使用原生 JDBC 进行数据库操作的场景往往是令人头疼的手动加载驱动、创建 Connection、编写冗长的 PreparedStatement、循环遍历 ResultSet 并逐个取字段设置到 Java 对象最后还要在 finally 块中依次关闭资源。这不仅代码臃肿还极易因忘关连接而引发资源泄露同时 SQL 硬编码在 Java 代码中使得维护变得困难。MyBatis 的出现并非为了成为“全自动”ORM 框架它选择了一条中间道路将 SQL 的控制权交还给开发者同时自动化了参数绑定、结果集映射、连接管理这些重复且易出错的环节。它既避免了 JDBC 的繁琐又不会像 Hibernate 那样隐藏 SQL 生成细节导致复杂查询调优困难。核心问答Q在 JPA/Hibernate 盛行的今天为什么很多团队仍然坚持 MyBatisA因为“全自动”ORM 在对象模型与关系模型之间存在“阻抗失配”尤其在复杂报表、多表关联、动态条件、存储过程调用等场景下自动生成的 SQL 往往性能低下且难以控制。MyBatis 允许开发者直接编写优化过的 SQL同时通过动态 SQL 标签解决拼接难题保留了性能调优的空间。对于以数据为中心、SQL 逻辑复杂的应用这种半自动的方式反而更具生产力。2. 整体架构概览MyBatis 采用经典的分层架构从上到下可分为三层接口层提供给应用调用的 API主要是SqlSession接口和 Mapper 接口。开发者通过SqlSession执行语句或通过 Mapper 动态代理调用。数据处理层核心执行逻辑包括参数映射、SQL 解析、SQL 执行、结果映射。主要由Executor、StatementHandler、ParameterHandler、ResultSetHandler协作完成。基础支撑层提供通用基础能力包括配置解析(Configuration)、I/O 读取、事务管理、缓存、日志、反射、类型转换、数据源连接等。核心组件交互全景一次查询请求从接口层发起经SqlSession委托给ExecutorExecutor先处理缓存若配置二级缓存则包装CachingExecutor随后调用StatementHandler创建Statement并通过ParameterHandler设置参数执行 SQL 后由ResultSetHandler将结果映射为 Java 对象最后返回给调用者。核心问答Q一次查询请求在 MyBatis 各层之间是如何流转的A以session.selectOne(findUser, 1)为例调用进入DefaultSqlSession它会从Configuration中获取对应的MappedStatement然后交给Executor执行。Executor检查是否存在缓存若无则通过StatementHandler预编译 SQL 并使用ParameterHandler填充参数1执行 JDBC 查询ResultSetHandler根据映射配置将 ResultSet 转换成 User 对象返回。3. 全流程解析从获取连接到处结果集3.1 一条 SQL 的完整生命周期整个流程可概括为构建 Configuration → 打开 SqlSession → 获取 Mapper 代理 → 调用方法 → 解析 SQL 与参数 → 获取连接 → 执行 → 处理结果 → 事务提交/回滚 → 关闭会话。3.2 起点Configuration 与 SqlSessionFactory 的构建SqlSessionFactoryBuilder通过 XML 或 Java 配置构建出Configuration对象它是 MyBatis 的“元数据中心”保存了所有MappedStatement、参数映射、结果映射、类型处理器、插件列表、数据源等信息。Configuration是全局唯一的重量级对象随后用它创建SqlSessionFactory默认实现为DefaultSqlSessionFactory。3.3 注册驱动 / 获取连接DataSource 的幕后工作MyBatis 不负责驱动注册它依赖 JDBC 4.0 的 SPI 自动加载或通过dataSource中配置的驱动类名显式加载。连接管理交由数据源实现池化PooledDataSource、非池化UnpooledDataSource或 JNDI。Executor在执行 SQL 时会从DataSource获取Connection事务提交或关闭时归还。3.4 解析 SQL动态 SQL 与 SqlSource 的诞生XML 中的 SQL包括if、foreach等标签会被解析成SqlSource。静态 SQL 对应StaticSqlSource动态 SQL 则构建为DynamicSqlSource。运行时SqlSource根据参数对象生成BoundSql其中包含最终的 SQL 字符串、参数映射列表ParameterMapping等。BoundSql还记录了#{}占位符替换为?后的 SQL 以及每个?对应的 Java 属性路径。核心问答QMyBatis 如何处理动态 SQL 中的#{}与${}A#{}在解析时被替换为?并生成ParameterMapping通过PreparedStatement安全设置参数能防止 SQL 注入。${}直接进行字符串替换将内容拼接到 SQL 中通常用于动态表名或列名但有注入风险需谨慎使用。3.5 解析参数ParameterHandler 与类型映射ParameterHandler负责将传入的 Java 对象如 User、Map、Integer转换为 JDBC 参数。它遍历BoundSql中的ParameterMapping列表利用TypeHandler从参数对象上获取属性值如通过反射或 OGNL并调用PreparedStatement.setXxx设置到 SQL 占位符。3.6 执行核心Executor 的调度与一级缓存Executor实现类SimpleExecutor、ReuseExecutor、BatchExecutor负责执行。一级缓存本地缓存是BaseExecutor中维护的 HashMap作用域为SqlSession级别。同一个SqlSession执行相同的MappedStatement和参数组合时若未发生增删改操作会直接返回缓存结果。执行流程中会调用StatementHandler创建Statement并执行。3.7 事务边界回滚/提交的决策机制Transaction接口JdbcTransaction/ManagedTransaction管理 Connection 的提交与回滚。SqlSession默认为非自动提交通过commit()显式提交。若发生异常在 finally 中调用rollback()回滚。使用ManagedTransaction时则依靠容器管理事务如 Spring 整合后由 Spring 事务管理器控制。3.8 结果映射ResultSetHandler 与复杂对象装配ResultSetHandler处理 JDBCResultSet根据ResultMap配置将每一行数据映射为 Java 对象。简单映射直接通过构造方法或 setter 注入复杂映射如关联association、集合collection会通过嵌套查询或分步查询解析。自动映射下划线转驼峰 (mapUnderscoreToCamelCase) 也在此环节完成。核心问答Q一级缓存何时失效如何自动映射下划线转驼峰A一级缓存与SqlSession同生命周期当执行增删改操作insert/update/delete时会清空也可手动调用clearCache()清空。自动映射下划线转驼峰由Configuration.mapUnderscoreToCamelCase控制ResultSetHandler在匹配列名与属性时会替换下划线并转换为驼峰形式。4. 核心组件深度拆解4.1 Configuration全局配置中枢Configuration是 MyBatis 的“注册中心”包含所有MappedStatement、TypeHandler、ResultMap、Interceptor链、Executor类型、Cache配置等。启动时通过 XMLConfigBuilder 解析 mybatis-config.xml 填充随后作为不可变对象随SqlSessionFactory共享。4.2 SqlSessionFactory SqlSession门面与生命周期SqlSessionFactory是线程安全的单例工厂负责创建SqlSession由DefaultSqlSession实现。SqlSession是非线程安全的与一次数据库会话绑定使用后必须关闭。它提供了selectOne、selectList、insert、update、delete等方法并暴露了获取Mapper接口代理的能力。4.3 Executor 家族Simple、Reuse、BatchSimpleExecutor每次执行都创建新的Statement执行后关闭。ReuseExecutor重用Statement将其缓存在一个 Map 中key 为 SQL避免重复预编译。BatchExecutor批量执行模式调用addBatch累积通过doFlushStatements一次性执行适用于批量插入。CachingExecutor当二级缓存开启时它装饰上述执行器先查缓存再委托给底层执行器。核心问答Q如何选择 Executor 类型A在settings中配置defaultExecutorType。通常默认SIMPLE即可若需要批量执行可使用BATCH但需手动刷新REUSE适合连接有限且大量重复 SQL 的场景。4.4 MapperProxy基于动态代理的接口绑定MyBatis 通过 Java 动态代理将 Mapper 接口的方法调用转换为 SQL 执行。MapperProxy实现InvocationHandler拦截方法调用根据接口全限定名和方法名从Configuration获取对应的MappedStatement然后调用SqlSession的执行方法。这避免了手动编写实现类。4.5 MapperProxyFactory代理工厂的注册与生成每个 Mapper 接口在初始化时会注册一个MapperProxyFactory它持有接口的Class对象。调用SqlSession.getMapper()时工厂通过Proxy.newProxyInstance创建MapperProxy实例。工厂内部可使用MethodCache缓存方法对应的细节。4.6 Transaction事务抽象Transaction接口定义了getConnection()、commit()、rollback()、close()方法。JdbcTransaction直接使用 JDBC 的提交/回滚ManagedTransaction不做任何提交回滚操作将控制权交给外部容器。在 Spring 整合中SpringManagedTransaction会参与到 Spring 事务管理器中。4.7 缓存机制一级缓存与二级缓存一级缓存本地缓存BaseExecutor中的localCachePerpetualCache在同一个SqlSession中有效。当执行更新、执行commit/rollback或手动clearCache()时缓存会被清空。若开启二级缓存一级缓存会作为二级缓存的写入口。二级缓存全局缓存由CachingExecutor实现缓存数据存放在Mapper的namespace级别的Cache实例中可集成 Ehcache、Redis 等。CachingExecutor负责事务缓存层TransactionalCacheManager临时存放未提交事务的数据提交后刷新到二级缓存。二级缓存要求实体类可序列化且多表关联查询可能产生脏数据需谨慎使用。核心问答Q二级缓存的脏数据是怎么产生的如何避免A当多个SqlSession操作同一张表时若一个会话更新了表数据但未提交另一个会话从二级缓存读取旧数据提交后缓存依旧未刷新造成脏读。避免方式1使用细粒度的缓存分区2更新操作时清空相关的命名空间缓存3对一致性要求高的场景不使用二级缓存转而依赖 Redis 等集中式缓存并在业务层控制刷新。4.8 插件体系拦截器链与实战MyBatis 利用动态代理的责任链模式实现了插件机制。插件需实现Interceptor接口标注Intercepts和Signature指定要拦截的类和方法。可拦截对象包括Executor(update/query/flushStatements/commit/rollback)StatementHandler(prepare/parameterize/batch/update/query)ParameterHandler(getParameterObject/setParameters)ResultSetHandler(handleResultSets/handleOutputParameters)插件通过Configuration的interceptorChain注册包装目标对象时生成多层代理。常见应用有分页拦截器如 PageHelper、SQL 日志打印、数据脱敏等。核心问答Q插件是如何改变 MyBatis 行为的A以分页插件为例它拦截Executor.query方法在查询前获取参数中的分页信息将原 SQL 转换为带有LIMIT的分页 SQL并修改参数映射然后调用原方法执行最后组装分页结果。4.9 MappedStatement 与方法签名如何唯一定位 SQLMappedStatement封装了一条 SQL 的全部信息id命名空间 语句 ID、SqlSource、ResultMap、StatementType、Cache等。方法签名即 Mapper 接口中的方法通过接口全限名 方法名与MappedStatement.id对应。MyBatis 还支持方法重载但由于id唯一重载方法需要不同的映射配置通常通过不同的 XMLselect标签指定参数类型。5. 基础支撑模块5.1 IO 与 VFS读取 Jar 内部及文件系统资源MyBatis 利用Resources类加载配置文件底层使用 ClassLoader 的getResourceAsStream。VFS虚拟文件系统模块用于扫描包下类如查找typeAliases默认提供DefaultVFS和JBoss6VFS可扩展实现从 Jar 包中读取文件。核心问答QMyBatis 为何要自己实现 VFS而不直接用 Spring 的资源扫描AMyBatis 作为一个独立框架不能依赖 Spring。VFS 确保在不同容器如 JBoss、OSGi下正确读取 Jar 内资源并通过 SPI 支持自定义实现。5.2 Parsing 模块XML 解析与动态 SQL使用XPathParser封装 XPath 对 XML 的解析。动态 SQL 标签通过 OGNL 表达式求值DynamicContext在解析过程中拼接 SQL 片段。GenericTokenParser处理#{}和${}占位符替换。5.3 Logging日志框架适配与 JDBC 异常封装MyBatis 采用日志适配器模式依次检测 SLF4J、Log4j2、Log4j、JDK Logging 等并将其封装为Log接口。JdbcExceptionTranslator将 SQL 异常码转换为更明晰的PersistenceException子类。5.4 Type 体系数据库类型与 Java 类型的桥梁TypeHandler接口及其实现类负责 Java 类型与 JDBC 类型之间的双向转换。BaseTypeHandler抽象类简化了实现。TypeHandlerRegistry在启动时注册内建的处理器并允许用户自定义如将数据库 JSON 字符串映射为 Java 对象。核心问答Q如何处理数据库 JSON 字段A实现TypeHandlerJsonObject在setParameter中将 Java 对象序列化为 JSON 字符串在getResult中反序列化并注册到TypeHandlerRegistry或通过MappedTypes注解指定即可。5.5 Reflection通用反射工具包MyBatis 的反射模块提供MetaObject支持对任意对象属性进行导航式访问和设置基于 OGNL 解析器并能处理集合、Map 和普通 JavaBean。ObjectWrapper是对不同类型对象的包装如BeanWrapper处理 JavaBean、MapWrapper处理 Map 等。5.6 Exception异常层次体系MyBatis 将原始的SQLException包装为PersistenceException并有TooManyResultsException、BindingException等子类形成运行时异常体系便于统一异常处理。5.7 Annotation 与 Lang注解驱动的配置Select、Insert、Update、Delete提供简单语句SelectProvider支持动态 SQL。Results和Result配置结果映射。Lang注解指定自定义脚本语言如 MyBatis 默认的 XML 语言。XMLLanguageDriver是默认驱动解析 XML 中的script标签。6. 总结与最佳实践回顾全文MyBatis 通过分层的架构将 SQL 的控制与执行自动化完美结合。一张图串联所有模块应用层调用 →SqlSession→Executor→StatementHandler含ParameterHandler、ResultSetHandler→ JDBC并横向辅以缓存、事务、插件、日志等支撑体系。最佳实践建议缓存一级缓存无需关心二级缓存仅在单表查询频繁且变更少的场景使用并确保缓存刷新策略正确。批量操作使用BatchExecutor或SqlSession的batch模式配合合适的batchSize避免大量单条提交。连接池生产环境使用成熟连接池如 HikariCP配置合理超时与最大连接数。事务管理与 Spring 集成时将事务边界交给Transactional确保SqlSession的生命周期与事务同步。SQL 注入防范尽量使用#{}避免${}用于外部不可信输入。核心问答QService 层调用多次 Mapper 方法如何保证它们在同一个事务中A在 Spring 环境下通过Transactional注解保证 Service 层方法内的所有数据库操作共享同一个数据库连接线程绑定的SqlSession因此它们处于同一事务中要么一起提交要么一起回滚。本文从技术视角深入剖析了 MyBatis 的全流程与核心模块希望能为读者理解与运用 MyBatis 提供清晰的脉络。