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

MyBatis 的一级缓存默认就起作用，二级缓存需要配置才能用；真正提升查询性能的关键，不是“开了没开”，而是清楚什么时候该用、怎么配、哪些操作会让它失效。

一级缓存：同一个 SqlSession 内自动加速

它不需要写任何配置，只要在同一个 SqlSession 中执行两次完全一样的查询（SQL 语句、参数类型和值、分页参数都一致），第二次就会直接从内存返回结果，不走数据库。

• 缓存 key 由 MappedStatement ID、SQL 字符串、参数值、RowBounds 等共同生成——Integer(1) 和 String("1") 会被视为不同 key，导致不命中
• 执行 INSERT/UPDATE/DELETE、调用 sqlSession.clearCache()、事务 commit/rollback，都会清空当前 SqlSession 的全部一级缓存
• 不同 SqlSession 之间完全隔离，哪怕查同一行数据，也不共享缓存
• 在 Spring 中配合 @Transactional 使用时，每次方法调用通常新建 SqlSession → 一级缓存基本失效，这点要特别注意

二级缓存：跨 SqlSession 的 Mapper 级共享

它让多个会话能复用同一份查询结果，但必须显式开启，且有前提条件。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 全局开关要打开：<setting name="cacheEnabled" value="true"></setting>（mybatis-config.xml）
• 每个 Mapper 需声明缓存：<cache></cache>（XML）或 @CacheNamespace（接口注解）
• 实体类必须实现 Serializable，否则反序列化失败，缓存写入会静默失败
• 任意写操作（如 update）会清空整个 Mapper namespace 下的二级缓存，不只是某条记录
• 可对单条 SQL 禁用缓存：<select usecache="false"></select>

缓存真正有效的三个前提

不是所有场景都适合上缓存，盲目开启反而可能引发数据不一致或序列化异常。

• 读多写少：比如省市区字典表、系统配置项，一天改几次，但被查成千上万次
• 允许弱一致性：用户头像、文章分类这类更新不频繁、稍有延迟无影响的数据可以缓存；订单状态、账户余额等强一致性场景慎用二级缓存
• 查询成本高：带多表 JOIN、GROUP BY、子查询的 SQL 更值得缓存；简单主键查询若本身很快，缓存收益有限

常见失效与避坑点

很多项目说“缓存没效果”，其实卡在几个典型问题上。

• Mapper 接口方法没加 @Select 或 XML 中没写 <select></select> 标签 → 不进入缓存流程
• 用了 MyBatis-Plus 的 wrapper 查询但没指定 resultType → CacheKey 生成异常，缓存无法命中
• 一级缓存中取对象后直接修改属性（如 user.setName("xxx")），后续再 get 同一对象会拿到已改过的引用 → 建议查完立即 copy 或启用 localCacheScope=STATEMENT 避免副作用
• 集成 Redis 做二级缓存时，忘了配置序列化器或实体类缺少无参构造 → 缓存读写失败却不报错

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南