Hibernate二级缓存ehcache.xml配置文件怎么写

ehcache.xml 是 Ehcache 1.x/2.x 的 XML 配置文件，需置于 classpath 根目录；Hibernate 4.x/5.2- 依赖它实现二级缓存，而 Hibernate 5.3+ 推荐 JCache 抽象层。

<p>ehcache.xml 是 Ehcache 1.x（常用于老版本 Hibernate，如 4.x）的缓存配置文件，放在 <strong>classpath 根目录</strong>（如 src/main/resources）下即可被 Hibernate 自动加载。注意：Ehcache 2.x 仍兼容此格式；Ehcache 3.x 已弃用 XML 配置，改用 Java 或 YAML，且 Hibernate 5.3+ 默认推荐使用 JCache（JSR-107）抽象层。</p>

<H3>基础 ehcache.xml 结构（适配 Hibernate 4.x / 5.2 及以下）</H3>
<p>以下是最简可用、符合 Hibernate 二级缓存要求的配置示例：</p>
<pre class="brush:php;toolbar:false;"><font size="2"><?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="ehcache.xsd">

  <!-- 磁盘缓存路径，需确保应用有写权限 -->
  <diskStore path="java.io.tmpdir/ehcache"/>

  <!-- 默认缓存策略（Hibernate 未显式指定缓存策略时使用）-->
  <defaultCache
      maxEntriesLocalHeap="1000"
      eternal="false"
      timeToIdleSeconds="300"
      timeToLiveSeconds="600"
      overflowToDisk="true"
      diskPersistent="false"
      diskExpiryThreadIntervalSeconds="120"
      memoryStoreEvictionPolicy="LRU"/>

  <!-- 为具体实体类或集合配置缓存（必须）-->
  <cache name="com.example.User"
      maxEntriesLocalHeap="500"
      eternal="false"
      timeToIdleSeconds="60"
      timeToLiveSeconds="300"
      overflowToDisk="true"/>

  <!-- 缓存集合（如 User.roles）-->
  <cache name="com.example.User.roles"
      maxEntriesLocalHeap="100"
      eternal="false"
      timeToIdleSeconds="30"
      timeToLiveSeconds="120"
      overflowToDisk="true"/>

</ehcache></font>

登录后复制

关键配置项说明

• diskStore path：建议用 java.io.tmpdir/ehcache 或绝对路径（如 /var/cache/myapp/ehcache），避免硬编码用户目录
• maxEntriesLocalHeap：堆内最大缓存条目数，避免 OOM；按实体热度合理设置，不要盲目调大
• eternal="false"：必须设为 false，否则 timeToIdleSeconds / timeToLiveSeconds 不生效
• timeToIdleSeconds：对象空闲多久后过期（不被访问）
• timeToLiveSeconds：对象创建后多久强制过期（不管是否访问）
• overflowToDisk：堆满后是否溢出到磁盘（开启需确保 diskStore 可写）
• cache name：必须与实体类全限定名（package.ClassName）或集合属性路径（package.ClassName.propertyName）完全一致

Hibernate 端需配合的配置

仅配置 ehcache.xml 不够，还需在 Hibernate 配置中启用二级缓存：

标签： java js 编码 app ai 配置文件 常见问题 overflow