MyBatis缓存双星：一级与二级缓存的深度解析与避坑指南

在数据库访问层，缓存是提升性能、降低数据库负载的利器。MyBatis提供了一级缓存和二级缓存两套机制，但许多开发者对其工作原理、作用域和失效条件混淆不清，常导致数据不一致或缓存命中率低下等问题。透彻理解MyBatis一级缓存与二级缓存原理区别，其核心价值在于能够根据业务场景（如数据实时性要求、会话隔离需求）正确选择和配置缓存策略，在提升性能的同时，精准规避“脏读”风险，构建高效且可靠的数据访问层。本文将从源码和实战角度，为你彻底厘清这两级缓存的奥秘。

一、 缓存全景图：MyBatis的两级缓存架构

首先建立宏观认知：MyBatis的缓存设计是分层级的。
一级缓存（Local Cache）：也称为本地缓存或会话级缓存。其生命周期与一个SqlSession绑定，默认开启且无法关闭。
二级缓存（Second Level Cache）：也称为应用级缓存或命名空间级缓存。其生命周期与一个SqlSessionFactory（即一个应用）绑定，需要手动配置开启，并可在多个SqlSession间共享。

理解这份MyBatis一级缓存与二级缓存原理区别，是合理使用它们的前提。在鳄鱼java的课程设计中，我们始终强调“先理解生命周期，再谈使用”。

二、 一级缓存深度解析：SqlSession的“私人备忘录”

1. 核心特征与生命周期 * 作用域：同一个SqlSession对象。当你执行查询时，结果会被缓存到该SqlSession内部的一个Map结构中。 * 默认状态：默认开启，无法全局禁用（但可通过配置影响其行为）。 * 存储位置：JVM堆内存中，属于进程内缓存。

2. 工作原理与代码透视 一级缓存本质上是一个基于`HashMap`的简单缓存，其键（CacheKey）由以下要素共同决定： * Mapper Statement ID（方法全限定名） * 查询的偏移量（RowBounds） * 传递给SQL的参数值 * 环境ID（如数据库配置） * 最终执行的SQL语句（BoundSql） 当在同一个SqlSession中执行两次完全相同的查询时，MyBatis会先根据上述要素生成一个CacheKey，然后在一级缓存的Map中查找。如果找到，则直接返回缓存对象，不再访问数据库。

3. 一级缓存的失效时机（至关重要！） 一级缓存并非永久有效，在以下操作后会自动清空（清除整个SqlSession内的缓存）： * 执行了INSERT、UPDATE、DELETE语句（无论是否影响本查询涉及的数据）。 * 手动调用`sqlSession.clearCache()`方法。 * 对Mapper配置文件中的``标签设置`flushCache=”true”`属性。 * 执行了事务提交（`commit()`）或回滚（`rollback()`）。 示例场景： try (SqlSession session = sqlSessionFactory.openSession()) { UserMapper mapper = session.getMapper(UserMapper.class); User user1 = mapper.selectById(1L); // 第一次查询，访问数据库 User user2 = mapper.selectById(1L); // 第二次查询，命中一级缓存，不访问数据库 mapper.updateName(1L, “新名字”); // 执行UPDATE操作 User user3 = mapper.selectById(1L); // 一级缓存已清空，再次访问数据库 } 三、 二级缓存深度解析：跨会话共享的“公共资料库” 1. 核心特征与配置 * 作用域：Mapper命名空间（Namespace）级别，也可跨命名空间共享（通过``）。同一个SqlSessionFactory创建的所有SqlSession可以共享。 * 默认状态：默认关闭，需要在XML映射文件中显式配置 `` 标签来开启。 * 存储实现：默认使用内存HashMap，但可通过`type`属性集成Ehcache、Redis等第三方缓存库，实现分布式缓存。 2. 工作流程与序列化要求 二级缓存的工作流程更为复杂： 1. 查询时，MyBatis会先查看二级缓存中是否有数据。 2. 如果没有，再查看一级缓存。 3. 如果一级缓存也没有，才查询数据库。 4. 查询结果在返回给用户前，会同时存入一级和二级缓存。 5. **关键点**：当SqlSession关闭（`close()`）或提交（`commit()`）时，它才会将其一级缓存中的数据刷入（提交）到二级缓存中。这意味着，未提交的会话数据对其他会话不可见。 6. **重要要求**：由于二级缓存可能将数据序列化存储到磁盘或通过网络传输到其他节点，因此所有被缓存的POJO类都必须实现`Serializable`接口。 3. 可配置性与策略 ``标签支持丰富的配置： flushInterval=”60000” size=”512” readOnly=”true” /> 四、 核心区别对比：一张表看清本质 对比维度一级缓存二级缓存 作用域同一个SqlSession同一个SqlSessionFactory（Mapper Namespace） 生命周期随SqlSession的创建而创建，随其关闭而销毁与整个应用生命周期一致（除非被清空） 默认开启是否，需显式配置 存储位置JVM堆内存（SqlSession内部）JVM堆内存（可扩展至Redis等外部存储） 数据共享无法跨会话共享跨所有SqlSession共享 性能影响微乎其微，但能避免会话内重复查询可大幅降低数据库压力，但引入网络/序列化开销 脏读风险低（会话隔离）高，需谨慎设计更新策略和过期时间 序列化要求无有，缓存对象需实现Serializable 这张对比表清晰地揭示了MyBatis一级缓存与二级缓存原理区别的本质：一级缓存是面向会话的、轻量的、自动的数据快照；二级缓存是面向应用的、可配置的、共享的数据池。 五、 缓存失效与脏读：你必须警惕的陷阱 1. 二级缓存的脏读问题 这是二级缓存最大的风险。假设服务A在SqlSession-1中更新了用户信息但未提交，服务B在SqlSession-2中查询同一用户，可能读到旧数据（如果二级缓存已有）。即使提交了，其他会话也可能在一段时间内（直到缓存过期或清空）读到过期数据。 2. 失效策略设计 * 针对性清空：在更新数据的语句上设置`useCache=”false”`或`flushCache=”true”`。 * 设置合理过期时间：通过`flushInterval`控制。 * 业务层面规避：对于实时性要求极高的数据（如库存、账户余额），直接关闭对应Mapper的二级缓存。 在鳄鱼java参与的高并发电商项目中，我们对商品详情等读多写少、容忍一定延迟的数据使用二级缓存（配合Redis）；对于订单、支付核心链路，则禁用二级缓存，仅依赖数据库事务和精心设计的一级缓存使用。 六、 总结：如何在实际项目中做出正确选择 深入理解MyBatis一级缓存与二级缓存原理区别后，我们应如何决策？ 一级缓存：无需配置，理解其存在即可。要注意在长时间存活（如放在ThreadLocal中）的SqlSession中，它可能导致内存占用增加和读到中间状态数据。在Web应用中，通常一个请求一个SqlSession，此风险较低。 二级缓存：谨慎评估，按需启用。遵循以下原则： 1. 读远多于写：如配置数据、历史归档数据。 2. 数据一致性要求不高：允许短期（如几分钟）的数据延迟。 3. 数据量非巨大：避免缓存撑爆内存。 4. 做好防脏读设计：结合`flushCache`属性、设置短过期时间，或通过业务逻辑保证。 在鳄鱼java的架构评审中，启用二级缓存必须经过上述条件的审视，并配有相应的监控和失效方案。记住，缓存是性能的“加速器”，但也可能是数据一致性的“破坏者”。 现在，请审视你的MyBatis项目：你是否盲目开启了所有Mapper的二级缓存？那些被缓存的实体类实现`Serializable`接口了吗？在涉及多表关联更新时，你是否考虑了关联Mapper缓存的清空？带着对这些问题的思考去优化你的缓存策略，你将从简单地“使用框架”走向“驾驭框架”。