mybatis一级缓存默认生效、sqlsession级、自动清空;二级缓存需手动开启、mapper级共享,依赖cacheenabled和配置;二者适用前提为读多写少、允许弱一致性、查询成本高且对象可序列化。

MyBatis 一级缓存默认生效,二级缓存需手动开启,两者配合能显著减少数据库查询次数。关键不在“开不开”,而在于“什么时候用、怎么配、哪些情况会失效”。
一级缓存:SqlSession 内的自动加速器
它不需要任何配置,只要用同一个 SqlSession 执行两次完全相同的查询(SQL + 参数完全一致),第二次就直接从内存 HashMap 中返回结果,不碰数据库。
- 缓存 key 由 MappedStatement ID、SQL 语句、参数、分页信息等共同组成,稍有差异就不命中
- 增删改操作(INSERT/UPDATE/DELETE)会清空当前 SqlSession 的全部一级缓存
- 事务提交(commit)或 SqlSession 关闭(close)后,缓存自动失效
- 不同 SqlSession 之间完全隔离,哪怕查的是同一张表同一行数据,也不共享
二级缓存:跨会话的 Mapper 级共享池
它作用于整个 Mapper 接口(即 namespace),多个 SqlSession 可复用同一份缓存结果,但必须显式启用。
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
- 全局开关要打开:
<setting name="cacheEnabled" value="true"></setting>(mybatis-config.xml 中) - 每个需要缓存的 Mapper 必须声明:
<cache></cache>(XML 方式)或@CacheNamespace(注解方式) - 查询语句默认使用二级缓存;如需禁用某条 SQL,可设
useCache="false" - 写操作会清空该 Mapper 对应 namespace 下的全部二级缓存,不是只清某条记录
缓存使用效果的关键前提
缓存不是万能的,只有满足以下条件时,才能真正提升性能:
- 数据读多写少——比如字典表、配置项、地区列表,修改频率低才适合长期缓存
- 允许短暂不一致——订单、账户余额等强一致性场景慎用二级缓存
- 查询成本高——带多表 JOIN、聚合计算、子查询的结果更值得缓存
- 对象可序列化——二级缓存默认使用 PerpetualCache(基于 HashMap),若集成 Redis/EhCache,实体类必须实现
Serializable
避坑提醒:常见失效与误用
缓存没起效?大概率掉进了这些坑里:
- 用了 Spring 的 @Transactional,每次方法调用都新建 SqlSession → 一级缓存失效
- Mapper 接口方法没加
@Select或 XML 中没写<select></select>标签 → 不走缓存流程 - 开启了二级缓存但没给实体类加
implements Serializable→ 反序列化失败,缓存写入失败 - 缓存中存的是对象引用,一级缓存内多次获取同一对象,修改其属性会影响后续读取结果(浅拷贝问题)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










