mybatis二级缓存需满足三个硬性条件才能实现跨sqlsession共享:全局cacheenabled开启、mapper中显式配置、pojo实现serializable;其作用域为mapper namespace,同一namespace下所有sqlsession共享同一缓存区,写操作提交后自动清空整个namespace缓存。

MyBatis 二级缓存不是“一开就共享”,而是要满足三个硬性条件并理解其作用域逻辑,才能真正实现跨 SqlSession 共享。核心在于:它按 Mapper namespace 划分缓存区域,多个会话只要操作同一 namespace,就能读写同一份缓存数据。
必须满足的三个启用前提
缺一不可,否则缓存不生效(静默失败很常见):
-
全局开关打开:在
mybatis-config.xml中确认<setting name="cacheEnabled" value="true"></setting>(默认为 true,但建议显式声明) -
Mapper 显式声明:在对应 XML 文件顶部添加
<cache></cache>;或在 Mapper 接口上加@CacheNamespace注解 -
实体类实现 Serializable:所有被查询返回的 POJO 必须实现
java.io.Serializable接口,否则缓存写入会失败(无报错,但数据不会进二级缓存)
跨会话共享是怎么发生的
二级缓存不绑定某个具体 SqlSession,而是绑定到 Mapper 的 namespace 字符串(通常是接口全限定名)。只要两个 SqlSession 调用的是同一个 namespace 下的 <select></select>,它们就共用同一块缓存区。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 会话 A 查询
UserMapper.selectById(1)→ 结果先入一级缓存,事务提交后 写入二级缓存 - 会话 B(全新 SqlSession)执行同样语句 → 直接从二级缓存取值,不查库
- 若两个不同 Mapper 文件设置了相同 namespace(不推荐),它们也会共享缓存
控制缓存行为的关键配置项
在 <cache></cache> 标签中可细化策略,避免“全有或全无”:
-
eviction="LRU":默认淘汰策略,移除最久未使用的缓存项(也可设FIFO、SOFT等) -
size="1024":限制该 namespace 最多缓存 1024 个对象(非字节大小) -
flushInterval="60000":每 60 秒自动清空一次(单位毫秒),适合对实时性要求不高的场景 -
readOnly="true":设为 true 时返回缓存对象的直接引用(快但不安全);默认 false(返回副本,安全但稍慢) -
useCache="false":加在某条<select></select>上,禁用该语句的二级缓存(如实时报表类查询)
写操作如何影响共享缓存
这是跨会话一致性的关键机制——不是局部刷新,而是整个 namespace 缓存清空:
- 只要任意 SqlSession 对该 namespace 执行了
INSERT/UPDATE/DELETE并 提交事务,该 namespace 的二级缓存立即全量失效 - 无需手动调用清除方法,MyBatis 自动触发
clear() - 这意味着:高写低读的业务(如订单明细)不适合开启二级缓存;而低写高读的业务(如省市区字典、配置项)非常合适
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










