如何禁用Hibernate L1缓存解决Spring Data JPA+PostgreSQL流式查询OOM

1. 核心配置错误导致缓存清理完全失效 #

• 你在配置类中手动定义的@Bean EntityManager，是通过entityManagerFactory.createEntityManager()创建的独立孤立实例，和Spring事务管理机制下、绑定到当前线程事务的共享持久化上下文完全不属于同一个对象。
• 代码中注入的这个自定义EntityManager，不会参与当前@Transactional方法的持久化上下文同步，后续调用的joinTransaction()、flush()、clear()操作，全部作用在这个孤立的EntityManager上，根本无法触达正在执行流式查询、持续加载百万实体的真实Session。这就是你手动加的缓存清理逻辑完全没有效果的直接原因。
• 你在堆转储中观察到的EntityKey数量是其他实体两倍的现象，正好对应了两个独立持久化上下文（一个是Spring事务托管的真实Session，一个是你自定义的孤立EntityManager）各自维护的缓存结构。

2. Hibernate L1缓存的固有特性认知偏差 #

• Hibernate的L1 Session缓存是Session级别的底层设计，不存在查询级别的“完全禁用L1缓存”的配置项。只要实体是被Session加载的，就一定会在持久化上下文中建立对应的MutableEntityEntry、托管实体引用、关联的EntityKey条目，这是框架的固有行为，无法通过QueryHint关闭。
• 你配置的几个QueryHint的实际生效范围和作用，和你预期的L1缓存控制完全无关：
  • HINT_FETCH_SIZE=1000：这个配置确实会透传给JDBC驱动，控制单次从数据库拉取的行数，是唯一实际生效的和流式读取相关的Hint。
  • HINT_CACHEABLE=false、HINT_CACHE_MODE=IGNORE：这两个配置控制的是L2二级缓存的行为，和L1缓存没有任何关联。
  • HINT_FLUSH_MODE=ALWAYS：设置每次查询前自动刷写持久化上下文的变更，不会主动清理L1缓存的实体条目。
  • HINT_READONLY=true：将实体标记为只读托管状态，跳过实体变更检查的开销，但不会把实体从L1缓存中移除。
    因此这些配置完全无法阻止L1缓存持续累积加载的实体，百万级数据下必然触发内存溢出。

1. 修正错误的EntityManager配置 #

• 删除你自定义的@Bean public EntityManager entityManager()方法，不要手动创建EntityManager实例。
• 在需要操作持久化上下文的业务类中，通过@PersistenceContext注解注入和当前事务同步的EntityManager代理，该代理会自动将方法调用转发到当前事务绑定的真实Session上，后续的缓存清理操作才能真正生效：

  @PersistenceContext
  private EntityManager entityManager;
  

2. 调整流式查询的缓存清理逻辑 #

• 方法上配置readOnly = true的事务属性，只读事务不需要追踪实体变更，可以大幅降低持久化上下文的内存开销。
• 按照固定处理批次清理L1缓存，不需要手动调用System.gc()，JVM会自动完成内存回收。修正后的业务方法示例：

  @Transactional(readOnly = true)
  public void doSomething() {
    AtomicInteger counter = new AtomicInteger();
    try(Stream<Foo> stream = fooRepository.findAll()) {
      stream.forEach(foo -> {
        int i = counter.incrementAndGet();
        // 每处理100条实体，清空持久化上下文，将托管实体从L1缓存移除
        if (i % 100 == 0) {
          entityManager.flush();
          entityManager.clear();
          logger.info("L1缓存已清理，当前处理数量: {}", i);
        }
        logger.info("当前处理序号: {}", i);
      });
    }
  }
  

3. 追加JPA配置优化 #

在entityManagerFactory的JPA属性中追加配置，进一步降低只读流式场景下的内存开销：

// 手动控制刷写时机，避免框架自动触发刷写带来的额外开销
jpaProperties.setProperty("hibernate.flush_mode", "MANUAL");
// 使用空拦截器，跳过不必要的持久化回调逻辑
jpaProperties.setProperty("hibernate.ejb.interceptor", "org.hibernate.EmptyInterceptor");

• 配合配置的fetchSize值，确保PostgreSQL驱动使用服务端游标读取数据，不会一次性将全量结果加载到客户端内存。

内容的提问来源于stack exchange，提问作者Jeep87c