【Java 开发日记】我们来说一下 MyBatis 的缓存机制MyBatis 的缓存机制是其性能优化的重要组成部分也是面试中非常高频的考察点。很多人只知道“一级缓存、二级缓存”但真正理解它们的生命周期、使用场景、失效时机、线程安全问题以及实际项目中的正确用法的人并不多。今天我们系统地把 MyBatis 缓存机制讲透。一、MyBatis 缓存分类总览缓存层级范围默认开启存储介质线程安全命中时机失效时机一级缓存SqlSession 级别开启内存HashMap否同一个 SqlSession 内相同查询SqlSession 关闭 / commit / rollback / update 等二级缓存Mapper 级别关闭内存 / Ehcache / Redis 等是需配置跨 SqlSession 的相同查询缓存时间到 / update 操作 / flushCachetrue查询缓存单个查询语句级别———通过 useCache / flushCache 属性控制—二、一级缓存Session 级缓存详解核心特点作用域同一个 SqlSession 生命周期内默认开启无法通过配置关闭只能通过清空的方式绕过存储结构PerpetualCache本质是一个 HashMap缓存 Key由 SQL 参数 环境 数据库 映射语句 ID 等组成什么时候命中一级缓存SqlSessionsessionsqlSessionFactory.openSession();Useru1session.selectOne(com.xxx.mapper.UserMapper.getUser,1);Useru2session.selectOne(com.xxx.mapper.UserMapper.getUser,1);System.out.println(u1u2);// true命中一级缓存返回同一个对象一级缓存失效的 6 大场景非常高频考点SqlSession 关闭最常见SqlSession 调用 commit() 或 rollback()执行了任意增删改操作即使是其他 Mapper 的 update手动调用session.clearCache()使用了flushCachetrue的查询语句不同 SqlSession 之间天然不共享代码验证一级缓存失效Useru1mapper.getUser(1);// 查数据库Useru2mapper.getUser(1);// 一级缓存命中session.commit();// commit 后一级缓存清空Useru3mapper.getUser(1);// 再次查询数据库三、二级缓存Mapper 级缓存 / Namespace 级缓存核心特点默认关闭需要手动开启作用域同一个 Mapper.xml同一个 namespace下的所有查询跨 SqlSession 共享线程安全MyBatis 内部使用了同步机制或第三方缓存实现开启二级缓存的步骤三种方式全局开启mybatis-config.xmlsettingssettingnamecacheEnabledvaluetrue//settingsMapper 级别开启最常用!-- 在 Mapper.xml 文件顶部 --cacheevictionLRU!--回收策略LRU、FIFO、SOFT、WEAK--flushInterval60000!-- 刷新间隔毫秒不写表示永不过期 --size512!-- 缓存最大对象数 --readOnlytrue!-- 是否只读true 性能更高但对象不可修改 --/单个查询使用二级缓存selectidgetUserresultTypeUseruseCachetrueflushCachefalseselect * from user where id #{id}/selectreadOnly 的重要性readOnly“true”MyBatis 直接返回缓存对象引用性能最高但不能修改对象readOnly“false”默认MyBatis 会序列化 反序列化生成新对象安全但性能稍差推荐大多数业务场景建议readOnlytrue除非你明确需要修改返回的对象。四、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-cacheMyBatis-Plus 缓存机制与原生 MyBatis 的对比实际项目中缓存踩过的坑与解决方案继续写开发日记