flushcache="true"在高频更新场景下不可靠,因其清缓存与db写入非原子、无跨mapper感知、并发窗口期导致脏读;应按场景选关闭缓存、ttl、精准失效或事件驱动清缓存。

在频繁更新的接口中,直接使用 flushCache="true" 并不能可靠防止二级缓存脏读,反而可能引发性能问题或逻辑错误。关键不在于“加不加 flush”,而在于**缓存策略是否与业务一致性要求匹配**。
为什么 flushCache="true 在高频更新场景下容易失效
MyBatis 的 flushCache="true" 仅在当前 SQL 执行后清空**当前命名空间(Mapper)下的二级缓存**,但存在几个现实限制:
- 非原子性:清缓存和写数据库是两个独立操作,若清缓存成功、DB 写入失败(如事务回滚),缓存就变为空或旧值,下次读会误返回 null 或过期数据;
-
无跨 Mapper 感知:比如
UserMapper.update()清了自己的缓存,但OrderMapper.selectByUserId()的缓存不会被连带清理,仍可能读到脏数据; - 高并发下窗口期明显:A 线程刚清完缓存,B 线程立刻查缓存(未命中)→ 查库 → 写入缓存,此时 A 的新数据还没落库,B 缓存的就是旧快照。
更稳妥的替代方案:按场景选型
与其依赖 flushCache,不如从架构层面收敛一致性风险:
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
-
读多写少 + 强一致性要求 → 关闭二级缓存:在对应 Mapper 的
<cache></cache>上设enabled="false",或直接删掉<cache></cache>标签,让每次查询都走 DB。这是最简单可靠的方案; - 允许短暂不一致 → 启用定时刷新或 TTL 缓存:用 Redis 代理二级缓存(如 MyBatis-Redis),设置合理过期时间(如 30s),比手动 flush 更平滑;
-
必须用二级缓存且强一致 → 改用 CacheKey 精准失效:自定义
Cache实现,在更新时根据参数(如 user_id)精准删除相关 key,而非全量 flush; - 复杂关联更新 → 改用应用层缓存 + 事件驱动清缓存:DB 更新后发 MQ/本地事件,由监听方异步清理 Redis 中所有关联 key(如 user:123、order:user:123),解耦且可控。
如果坚持用 flushCache="true",必须配合这些约束
仅在满足全部条件时才可谨慎启用:
- 该 Mapper 只负责单表 CRUD,无跨表 join 查询;
- 所有修改操作(insert/update/delete)都显式声明
flushCache="true"; - 对应 select 查询全部声明
useCache="true"(默认开启,但需确认没被父标签覆盖); - 整个业务流程处于同一事务内,且事务传播行为为
REQUIRED,确保 flush 和 DB 操作同生命周期; - 监控缓存命中率与清空频率,避免因高频 flush 导致缓存击穿(例如每秒清 100 次,缓存基本无效)。
一个典型误用示例
假设有接口:updateUser(User user),Mapper 中写成:
但同时存在另一个查询:selectUserWithOrders(int userId) 在 OrderMapper 中,它也缓存了用户订单数据。此时 flushCache="true" 对 UserMapper 生效,却对 OrderMapper 完全无影响 —— 订单结果集缓存依然存在,造成脏读。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










