MyBatis一级缓存默认生效、SqlSession级、自动清空；二级缓存需手动开启、Mapper级共享，依赖cacheEnabled和<cache/>配置；二者适用前提为读多写少、允许弱一致性、查询成本高且对象可序列化。
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 级共享
它让多个会话能复用同一份查询结果，但必须显式开启，且有前提条件。
- 全局开关要打开：
<setting name="cacheEnabled" value="true"/>（mybatis-config.xml） - 每个 Mapper 需声明缓存：
<cache/>（XML）或@CacheNamespace（接口注解） - 实体类必须实现
Serializable，否则反序列化失败，缓存写入会静默失败 - 任意写操作（如 update）会清空整个 Mapper namespace 下的二级缓存，不只是某条记录
- 可对单条 SQL 禁用缓存：
<select useCache="false">
缓存真正有效的三个前提
不是所有场景都适合上缓存，盲目开启反而可能引发数据不一致或序列化异常。
立即学习“Java免费学习笔记（深入）”；
- 读多写少：比如省市区字典表、系统配置项，一天改几次，但被查成千上万次
- 允许弱一致性：用户头像、文章分类这类更新不频繁、稍有延迟无影响的数据可以缓存；订单状态、账户余额等强一致性场景慎用二级缓存
- 查询成本高：带多表 JOIN、GROUP BY、子查询的 SQL 更值得缓存；简单主键查询若本身很快，缓存收益有限
常见失效与避坑点
很多项目说“缓存没效果”，其实卡在几个典型问题上。
- Mapper 接口方法没加
@Select或 XML 中没写<select>标签 → 不进入缓存流程 - 用了 MyBatis-Plus 的 wrapper 查询但没指定 resultType → CacheKey 生成异常，缓存无法命中
- 一级缓存中取对象后直接修改属性（如 user.setName("xxx")），后续再 get 同一对象会拿到已改过的引用 → 建议查完立即 copy 或启用 localCacheScope=STATEMENT 避免副作用
- 集成 Redis 做二级缓存时，忘了配置序列化器或实体类缺少无参构造 → 缓存读写失败却不报错
