【Java 开发日记】我们来说一下 MyBatis 的缓存机制
MyBatis 的缓存机制是其性能优化的重要组成部分，也是面试中非常高频的考察点。
很多人只知道“一级缓存、二级缓存”，但真正理解它们的生命周期、使用场景、失效时机、线程安全问题以及实际项目中的正确用法的人并不多。
今天我们系统地把 MyBatis 缓存机制讲透。
一、MyBatis 缓存分类总览
| 缓存层级 | 范围 | 默认开启 | 存储介质 | 线程安全 | 命中时机 | 失效时机 |
|---|---|---|---|---|---|---|
| 一级缓存 | SqlSession 级别 | 开启 | 内存（HashMap） | 否 | 同一个 SqlSession 内相同查询 | SqlSession 关闭 / commit / rollback / update 等 |
| 二级缓存 | Mapper 级别 | 关闭 | 内存 / Ehcache / Redis 等 | 是（需配置） | 跨 SqlSession 的相同查询 | 缓存时间到 / update 操作 / flushCache=true |
| 查询缓存 | 单个查询语句级别 | — | — | — | 通过 useCache / flushCache 属性控制 | — |
二、一级缓存（Session 级缓存）详解
核心特点：
- 作用域：同一个 SqlSession 生命周期内
- 默认开启，无法通过配置关闭（只能通过清空的方式绕过）
- 存储结构：
PerpetualCache（本质是一个 HashMap） - 缓存 Key：由 SQL + 参数 + 环境 + 数据库 + 映射语句 ID 等组成
什么时候命中一级缓存？
SqlSession session = sqlSessionFactory.openSession();
User u1 = session.selectOne("com.xxx.mapper.UserMapper.getUser", 1);
User u2 = session.selectOne("com.xxx.mapper.UserMapper.getUser", 1);
System.out.println(u1 == u2); // true！命中一级缓存，返回同一个对象一级缓存失效的 6 大场景（非常高频考点）：
- SqlSession 关闭（最常见）
- SqlSession 调用 commit() 或 rollback()
- 执行了任意增删改操作（即使是其他 Mapper 的 update）
- 手动调用
session.clearCache() - 使用了
flushCache=true的查询语句 - 不同 SqlSession 之间天然不共享
代码验证一级缓存失效：
User u1 = mapper.getUser(1); // 查数据库
User u2 = mapper.getUser(1); // 一级缓存命中
session.commit(); // commit 后一级缓存清空
User u3 = mapper.getUser(1); // 再次查询数据库三、二级缓存（Mapper 级缓存 / Namespace 级缓存）
核心特点：
- 默认关闭，需要手动开启
- 作用域：同一个 Mapper.xml（同一个 namespace）下的所有查询
- 跨 SqlSession 共享
- 线程安全（MyBatis 内部使用了同步机制或第三方缓存实现）
开启二级缓存的步骤（三种方式）：
- 全局开启（mybatis-config.xml）
<settings>
<setting name="cacheEnabled" value="true"/>
</settings>- Mapper 级别开启（最常用）
<!-- 在 Mapper.xml 文件顶部 -->
<cache
eviction="LRU" <!-- 回收策略：LRU、FIFO、SOFT、WEAK -->
flushInterval="60000" <!-- 刷新间隔（毫秒），不写表示永不过期 -->
size="512" <!-- 缓存最大对象数 -->
readOnly="true" <!-- 是否只读（true 性能更高，但对象不可修改） -->
/>- 单个查询使用二级缓存
<select id="getUser" resultType="User" useCache="true" flushCache="false">
select * from user where id = #{id}
</select>readOnly 的重要性：
- readOnly=”true”：MyBatis 直接返回缓存对象引用（性能最高，但不能修改对象）
- readOnly=”false”（默认）：MyBatis 会序列化 + 反序列化生成新对象（安全但性能稍差）
推荐：大多数业务场景建议 readOnly="true"，除非你明确需要修改返回的对象。
四、MyBatis 二级缓存常见问题与解决方案
- 脏读 / 数据不一致
原因：一个命名空间下的 update 会清空整个 namespace 的二级缓存
解决：使用 分布式缓存（Redis、Ehcache） + 合理的缓存 Key 设计 - 缓存穿透 / 缓存雪崩
解决：缓存空值、设置合理过期时间 - 多表关联查询缓存失效
解决：尽量把关联查询拆分成单表查询，或使用 Caffeine / Redis 做细粒度缓存 - Spring + MyBatis 二级缓存失效
原因：Spring 事务管理器每次 commit 都会清空一级缓存，二级缓存也可能受影响
解决：使用 MyBatis 官方的二级缓存 + 分布式缓存方案
五、现代项目中 MyBatis 缓存的真实用法（2025–2026）
| 场景 | 推荐做法 | 说明 |
|---|---|---|
| 小型项目、查询频繁 | 开启一级缓存 + 局部二级缓存 | 简单有效 |
| 中大型项目 | 关闭 MyBatis 二级缓存 | 容易脏读、难以维护 |
| 高并发、分布式 | 使用 Redis / Caffeine 做业务缓存 | 手动 put/get，细粒度控制 |
| 热点数据（配置、字典表） | Redis + MyBatis-Plus 缓存注解 | 更现代、更可控 |
| 复杂查询 | 关闭所有缓存 + 手动缓存 | 避免各种奇怪问题 |
一句话总结：
一级缓存是 SqlSession 的“临时记忆”，默认开启，适合同一个事务内的重复查询；
二级缓存是 Mapper 的“共享记忆”，默认关闭，适合读多写少的场景，但现代项目更倾向于关闭 MyBatis 自带二级缓存，转而使用业务层缓存（Redis、Caffeine）来实现更细粒度、更可控的缓存策略。
如果你想继续聊以下任一方向，可以告诉我：
- MyBatis 二级缓存的源码实现细节（Cache、PerpetualCache、LruCache）
- 如何在 Spring Boot 中优雅关闭 / 使用 MyBatis 二级缓存
- Redis 作为 MyBatis 二级缓存的完整方案（mybatis-redis-cache）
- MyBatis-Plus 缓存机制与原生 MyBatis 的对比
- 实际项目中缓存踩过的坑与解决方案
继续写开发日记～
