SpringBoot3/Hibernate6/EHCache3迁移缓存异常问题求助

核心问题根源：缓存配置重复初始化 #

你提到DemoEntity的缓存配置被JCache和Hibernate分别初始化两次，这是导致监听器失效、TTL不生效的核心原因——两个缓存实例并行工作，实际生效的可能不是你配置了监听器和TTL的那个实例。

一、依赖配置排查（pom.xml） #

Spring Boot 3 + Hibernate 6 整合EHCache 3时，必须避免依赖冲突，只保留正确的组合：

• 彻底移除旧EHCache 2依赖（如ehcache-core），只保留EHCache 3的JCache实现
• 不要同时引入Hibernate本地缓存依赖和JCache依赖，防止双实例冲突

错误示例（必须删除）：

<!-- 旧EHCache 2依赖，完全移除 -->
<dependency>
    <groupId>net.sf.ehcache</groupId>
    <artifactId>ehcache-core</artifactId>
</dependency>
<!-- 禁止同时引入Hibernate本地EHCache集成 -->
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-ehcache</artifactId>
</dependency>

正确依赖组合：

<!-- Spring Boot JCache starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-cache</artifactId>
</dependency>
<!-- EHCache 3 JCache实现 -->
<dependency>
    <groupId>org.ehcache</groupId>
    <artifactId>ehcache</artifactId>
</dependency>
<!-- Hibernate 6 JCache集成 -->
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-jcache</artifactId>
</dependency>

二、应用配置排查（application.yaml） #

明确指定Hibernate使用JCache作为二级缓存提供者，禁止Hibernate自行初始化缓存实例：

spring:
  jpa:
    properties:
      hibernate:
        cache:
          use_second_level_cache: true
          use_query_cache: true
          # 必须使用JCache区域工厂，而非旧EHCache工厂
          region.factory_class: org.hibernate.cache.jcache.JCacheRegionFactory
          jcache:
            provider: org.ehcache.jsr107.EhcacheCachingProvider
            # 强制指定EHCache配置文件路径，避免自动加载冲突
            config: classpath:ehcache.xml

注意：region.factory_class必须设为JCacheRegionFactory，否则Hibernate会单独初始化EHCache实例，和JCache实例形成双实例冲突。

三、EHCache配置排查（ehcache.xml） #

确保监听器、TTL配置使用EHCache 3语法，且绑定到正确缓存区域：

• 监听器直接配置在cache节点下，指定触发事件类型
• TTL用<ttl>标签，不要混用EHCache 2的timeToLiveSeconds属性

错误示例（EHCache 2语法，EHCache 3不兼容）：

<cache name="com.example.DemoEntity"
       maxEntriesLocalHeap="1000"
       timeToLiveSeconds="60">
    <cacheEventListenerFactory class="com.example.MyCacheListenerFactory"/>
</cache>

正确EHCache 3配置：

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns="http://www.ehcache.org/v3"
        xsi:schemaLocation="http://www.ehcache.org/v3 http://www.ehcache.org/schema/ehcache-core-3.0.xsd">

    <cache alias="com.example.DemoEntity">
        <key-type>java.lang.Long</key-type>
        <value-type>com.example.DemoEntity</value-type>
        <expiry>
            <ttl unit="seconds">60</ttl>
        </expiry>
        <listeners>
            <listener>
                <class>com.example.MyCacheListener</class>
                <event-firing-mode>ASYNCHRONOUS</event-firing-mode>
                <event-ordering-mode>UNORDERED</event-ordering-mode>
                <!-- 明确指定要触发的事件类型 -->
                <events-to-fire-on>CREATED</events-to-fire-on>
                <events-to-fire-on>EXPIRED</events-to-fire-on>
            </listener>
        </listeners>
        <resources>
            <heap unit="entries">1000</heap>
        </resources>
    </cache>
</config>

注意：EHCache 3不需要监听器工厂类，直接指定实现CacheEventListener的类即可；必须显式声明events-to-fire-on，否则不会触发对应事件。

四、实体类与监听器代码排查 #

1. 实体类缓存注解：使用Hibernate 6的@Cache注解，指定缓存区域，注意使用Jakarta EE注解：

import jakarta.persistence.Entity;
import org.hibernate.annotations.Cache;
import org.hibernate.annotations.CacheConcurrencyStrategy;

@Entity
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE, region = "com.example.DemoEntity")
public class DemoEntity {
    // 实体字段定义
}

禁止使用旧的javax.persistence包下的注解，Spring Boot 3已全面切换为Jakarta EE规范。

2. 监听器实现：实现EHCache 3的CacheEventListener接口，而非EHCache 2的旧接口：

import org.ehcache.event.CacheEvent;
import org.ehcache.event.CacheEventListener;

public class MyCacheListener implements CacheEventListener<Object, Object> {
    @Override
    public void onEvent(CacheEvent<?, ?> cacheEvent) {
        System.out.println("缓存事件触发：" + cacheEvent.getType() + "，键值：" + cacheEvent.getKey());
    }
}

不要继承旧版本的CacheEventListener类，否则无法被EHCache 3识别。

五、验证步骤 #

1. 启动项目后，查看日志，确认只加载了一次EHCache配置，无重复初始化日志
2. 执行数据库查询，检查监听器的日志输出，确认事件触发
3. 等待1分钟后再次查询，验证缓存是否过期并重新从数据库加载

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