Mybatis与Hibernate缓存的具体使用_Java

一、mybatis与hibernate缓存对比

1、hibernate 缓存机制

hibernate 的缓存体系分为一级缓存和二级缓存两层，核心作用是减少对数据库的直接访问，大幅提升数据查询性能。

一级缓存（session 级缓存）：它是 hibernate 内置且默认开启的缓存，无法手动关闭，生命周期与 session 完全绑定，仅在当前事务内生效。同一 session 中执行相同 id 的实体查询时，只会发起一次数据库访问，后续请求直接从内存缓存中返回对象，避免重复 sql 执行。当调用 session.clear()、session.close() 或事务结束时，一级缓存会被清空。
二级缓存（sessionfactory 级缓存）：属于全局共享缓存，可跨多个 session、甚至跨应用实例共享数据，默认不启用，需要手动配置第三方缓存插件（如 hibernate 默认支持的 ehcache）才能开启。它仅适合存储修改频率低、非核心的常量类数据，对于高频更新、财务类等对一致性要求极高的数据，禁止放入二级缓存，避免出现数据不一致问题。二级缓存支持事务型、读写型等4种并发访问策略，可根据业务场景匹配不同的事务隔离级别，保障缓存数据的安全性。
额外特性：hibernate 还配套提供 query 缓存，可对 hql 查询结果进行缓存，进一步优化批量检索场景的性能。

2、mybatis 缓存机制

mybatis 同样设计了两级缓存体系，但整体实现更轻量化，灵活性更高，同时对开发者的透明度更低。

一级缓存（sqlsession 级缓存）：默认自动开启，作用范围是当前 sqlsession，同一会话内执行相同参数的 mapper 查询时，会直接返回缓存结果，避免重复查库。当 sqlsession 执行任意一次增删改操作、调用 close() 或 clearcache() 方法时，一级缓存会被强制清空。
二级缓存（mapper 级缓存）：作用范围是同一个 mapper 的命名空间，可跨多个 sqlsession 共享数据，默认关闭，需要手动在配置文件中开启。开启后对应的 mapper 下所有查询语句会被缓存，增删改操作会自动清空该命名空间下的所有缓存数据。
核心特点：mybatis 缓存仅做简单的对象引用存储，不会像 hibernate 那样自动维护缓存与数据库的一致性，当存在多表关联查询、多命名空间交叉更新的场景时，极易出现脏数据，且框架本身不会给出任何异常提示，需要开发者手动控制缓存的失效逻辑。

3、两者核心差异对比

对比维度	hibernate 缓存	mybatis 缓存
自动化程度	高，框架自动维护缓存生命周期与数据同步	低，需开发者手动控制缓存的更新与失效
数据一致性保障	内置完善的并发策略，出现脏数据会主动提示	无自动校验，脏数据无任何告警，风险更高
缓存适配场景	适配绝大多数业务场景，对多表关联查询支持友好	更适合简单单表查询，复杂关联场景易出现一致性问题
配置复杂度	二级缓存需额外配置插件与并发策略，上手门槛略高	配置简单，仅需少量标签即可开启二级缓存

二、缓存常见错误与陷阱

1、mybatis 缓存常见错误与陷阱

mybatis 的缓存机制相对“轻量”且“透明”，这导致开发者往往忽略其底层实现细节，从而引发隐蔽的 bug。

一级缓存导致的“脏读”与线程安全问题
错误场景：在 web 应用中，错误地将 sqlsession 定义为类的成员变量或静态变量，导致多个请求线程共享同一个 sqlsession。
后果：

线程不安全：mybatis 一级缓存底层是 hashmap，无同步控制。多线程并发读写会导致数据错乱。
脏读风险：线程 a 修改了数据但未提交，线程 b 通过共享的 sqlsession 查询同一 id，可能读到线程 a 缓存中的旧数据或中间状态数据。

// ❌ 错误示范：sqlsession 作为成员变量，被多线程共享
public class userservice {
    private sqlsession sqlsession = mybatisutil.getsqlsessionfactory().opensession();

    public user getuserbyid(int id) {
        // 高并发下，不同线程可能读取到其他线程未提交的缓存数据
        return sqlsession.selectone("selectuser", id);
    }
}

正确做法：确保每个线程拥有独立的 sqlsession，通常在 service 层通过 spring 管理事务，或使用 try-with-resources 确保 session 随请求结束而关闭。

spring 事务中一级缓存失效或累积导致 oom
错误场景：

场景 a（失效）：在同一个事务中，先执行更新操作，再执行查询。虽然理论上 mybatis 会在更新时清空一级缓存，但如果使用了特定的传播行为（如 requires_new），会创建新的 sqlsession，导致前一个 session 的缓存不可见，看似“失效”。
场景 b（oom）：在长事务或大循环中频繁查询不同 id 的数据，且未手动清理缓存。由于一级缓存生命周期绑定 sqlsession，只要 session 不关闭，缓存会一直累积，最终导致堆内存溢出。

// ❌ 错误示范：长事务中大量查询不同id，导致一级缓存无限膨胀
@transactional
public void processlargedata() {
    for (int i = 0; i < 100000; i++) {
        // 每次查询不同id，结果都会存入当前sqlsession的一级缓存
        ordermapper.selectbyid(i); 
    }
    // 事务提交前，这10万个对象一直占用内存
}

正确做法：

对于批量处理，建议禁用一级缓存（设置 local-cache-scope: statement）。
或在循环中定期调用 sqlsession.clearcache()。

二级缓存的“序列化”与“多表关联”陷阱
错误场景：

序列化异常：开启二级缓存（尤其是集成 redis/ehcache）时，实体类未实现 serializable 接口，或者使用了不支持序列化的字段类型，导致缓存写入/读取失败。
多表关联脏数据：mybatis 二级缓存是基于 mapper namespace 的。如果 ordermapper 缓存了订单信息，而 itemmapper 更新了订单项并触发了 itemmapper 的缓存清空，但 ordermapper 的缓存并未感知到变化。此时查询订单，会得到包含旧订单项的脏数据。

<!-- ordermapper.xml -->
<mapper namespace="com.example.ordermapper">
    <cache/> <!-- 开启二级缓存 -->
    <select id="getorderwithitems" resulttype="order">
        select * from orders o join items i on o.id = i.order_id where o.id = {id}
    </select>
</mapper>
<!-- itemmapper.xml -->
<mapper namespace="com.example.itemmapper">
    <cache/>
    <update id="updateitem">
        update items set name = {name} where id = {id}
    </update>
</mapper>

后果：更新 item 后，ordermapper 中的联合查询结果仍然是旧的，因为两个 mapper 的缓存空间是隔离的。
正确做法：

避免在二级缓存中使用复杂的多表关联查询。
使用 <cache-ref> 让多个 mapper 共享同一个缓存空间，但这会降低缓存命中率。
最佳实践：在分布式或多服务架构中，彻底禁用 mybatis 二级缓存，改用 redis 等外部集中式缓存，由业务代码控制缓存一致性。

微服务架构下的一级缓存误导
错误场景：在微服务环境中，默认开启一级缓存。如果服务实例 a 查询了数据，随后服务实例 b（或同一实例的其他事务）修改了数据库，实例 a 的后续查询仍可能命中本地一级缓存（如果 sqlsession 未正确关闭或复用），导致数据不一致。
建议：在 application.yml 中显式配置 local-cache-scope: statement 以禁用一级缓存，依赖外部缓存或数据库实时性。

2、hibernate 缓存常见错误与陷阱

hibernate 缓存更智能，但也更复杂。错误通常源于对“对象状态”和“缓存策略”的误解。

二级缓存策略选择不当导致数据不一致
错误场景：对高频更新的数据（如库存、账户余额）使用了 read-only 或 nonstrict-read-write 策略，甚至在集群环境下未配置正确的并发锁机制。
后果：

脏数据：节点 a 更新了数据并更新了缓存，节点 b 的缓存未及时失效或更新，导致用户读到旧值。
异常抛出：如果使用 read-only 策略却尝试更新实体，hibernate 会直接抛出异常。

// ❌ 错误配置：对频繁变动的财务数据使用只读缓存
@entity
@cache(usage = cacheconcurrencystrategy.read_only) // 严禁用于可写数据
public class accountbalance { ... }

正确做法：

仅将极少修改、非核心、允许短暂不一致的数据（如字典表、配置项）放入二级缓存。
对于强一致性要求的数据，禁止使用二级缓存，或采用 transactional 策略（需 jta 支持）。

query cache 与二级缓存配合失误
错误场景：启用了 query cache (hibernate.cache.use_query_cache=true)，但未启用二级缓存，或者查询条件中包含动态参数但未正确理解缓存 key 的生成规则。
原理：query cache 存储的是查询结果集的 id 列表，而不是实体对象本身。实体对象仍需从二级缓存或数据库加载。
后果：

如果二级缓存未启用，query cache 命中后，hibernate 仍需根据 id 逐个去数据库加载实体，性能提升有限，反而增加了内存开销。
如果表数据更新，query cache 会自动失效，但若依赖 query cache 优化高频相同条件查询，需注意其失效频率。

// ❌ 错误用法：期望 query cache 能缓存整个对象图
query query = session.createquery("from user u where u.age > :age");
query.setparameter("age", 18);
query.setcacheable(true); // 仅缓存了 id 列表
list<user> users = query.list(); 
// 如果二级缓存没开，这里会根据 id 再次查库

session 管理不当导致一级缓存内存泄漏
错误场景：在一个长生命周期的 session 中执行大量的 load() 或 list() 操作，且不调用 session.clear()。
后果：hibernate 一级缓存（session 级）会持有所有加载过的持久化对象引用。随着操作增多，jvm 堆内存被占满，触发 full gc 甚至 oom。
典型场景：批量导入/导出几万条数据时，使用同一个 session。

// ❌ 错误示范：批量处理未清理 session 缓存
session session = sessionfactory.opensession();
transaction tx = session.begintransaction();
for (int i = 0; i < 50000; i++) {
    user user = session.get(user.class, i); // 每个对象都进入一级缓存
    user.setname("updated");
    if (i % 50 == 0) {
        session.flush();
        session.clear(); // ✅ 必须定期清理，否则 oom
    }
}
tx.commit();
session.close();

load() 与 get() 混淆引发的 lazyinitializationexception
错误场景：使用 session.load() 获取对象，该对象是一个代理对象（proxy）。如果在 session 关闭后访问其非 id 属性，会抛出异常。
原因：load() 优先从缓存查找，若缓存无则返回代理对象，不立即查库。若后续访问属性时 session 已关闭，无法初始化代理。
对比：get() 总是立即查库（若缓存无），返回真实对象或 null。

user user = session.load(user.class, 1l); // 返回代理对象，不查库
session.close();
system.out.println(user.getname()); // ❌ 抛出 lazyinitializationexception

3、总结与最佳实践建议

维度	mybatis 避坑指南	hibernate 避坑指南
一级缓存	微服务/分布式环境下建议禁用 (`statement` 模式)，避免脏读和内存累积。确保 sqlsession 线程隔离。	严格管理 session 生命周期。批量操作务必定期 `clear()`。理解 `load` vs `get` 的区别。
二级缓存	慎用。多表关联易出脏数据。建议仅在单表、读多写少场景使用，或直接交由 redis 处理。	精选数据。仅缓存不变或极少变的字典/配置数据。避免缓存金融/库存等强一致性数据。
一致性	框架不保证跨 mapper 的一致性。需开发者手动维护或通过外部缓存解决。	框架提供较好的并发策略，但配置复杂。需根据事务隔离级别选择合适的 `cacheconcurrencystrategy`。
调试	开启 sql 日志，观察是否重复执行相同 sql。监控缓存命中率。	开启 hibernate statistics，监控 l1/l2 cache hit/miss 比例，识别内存泄漏。