ehcache.xml 是 Ehcache 1.x/2.x 的 XML 配置文件，需置于 classpath 根目录；Hibernate 4.x/5.2- 依赖它实现二级缓存，而 Hibernate 5.3+ 推荐 JCache 抽象层。
ehcache.xml 是 Ehcache 1.x（常用于老版本 Hibernate，如 4.x）的缓存配置文件，放在 classpath 根目录（如 src/main/resources）下即可被 Hibernate 自动加载。注意：Ehcache 2.x 仍兼容此格式；Ehcache 3.x 已弃用 XML 配置，改用 Java 或 YAML，且 Hibernate 5.3+ 默认推荐使用 JCache（JSR-107）抽象层。
基础 ehcache.xml 结构（适配 Hibernate 4.x / 5.2 及以下）
以下是最简可用、符合 Hibernate 二级缓存要求的配置示例：
zuojiankuohaophpcn?xml version="1.0" encoding="UTF-8"?youjiankuohaophpcn zuojiankuohaophpcnehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="ehcache.xsd"youjiankuohaophpcn zuojiankuohaophpcn!-- 磁盘缓存路径，需确保应用有写权限 --youjiankuohaophpcn zuojiankuohaophpcndiskStore path="java.io.tmpdir/ehcache"/youjiankuohaophpcn zuojiankuohaophpcn!-- 默认缓存策略（Hibernate 未显式指定缓存策略时使用）--youjiankuohaophpcn zuojiankuohaophpcndefaultCache maxEntriesLocalHeap="1000" eternal="false" timeToIdleSeconds="300" timeToLiveSeconds="600" overflowToDisk="true" diskPersistent="false" diskExpiryThreadIntervalSeconds="120" memoryStoreEvictionPolicy="LRU"/youjiankuohaophpcn zuojiankuohaophpcn!-- 为具体实体类或集合配置缓存（必须）--youjiankuohaophpcn zuojiankuohaophpcncache name="com.example.User" maxEntriesLocalHeap="500" eternal="false" timeToIdleSeconds="60" timeToLiveSeconds="300" overflowToDisk="true"/youjiankuohaophpcn zuojiankuohaophpcn!-- 缓存集合（如 User.roles）--youjiankuohaophpcn zuojiankuohaophpcncache name="com.example.User.roles" maxEntriesLocalHeap="100" eternal="false" timeToIdleSeconds="30" timeToLiveSeconds="120" overflowToDisk="true"/youjiankuohaophpcn zuojiankuohaophpcn/ehcacheyoujiankuohaophpcn关键配置项说明
-
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 配置中启用二级缓存：
- hibernate.cfg.xml 或 application.properties 中添加：
zuojiankuohaophpcnproperty name="hibernate.cache.use_second_level_cache"youjiankuohaophpcntruezuojiankuohaophpcn/propertyyoujiankuohaophpcn zuojiankuohaophpcnproperty name="hibernate.cache.region.factory_class"youjiankuohaophpcnorg.hibernate.cache.ehcache.EhCacheRegionFactoryzuojiankuohaophpcn/propertyyoujiankuohaophpcn zuojiankuohaophpcn!-- 或用 SingletonEhCacheRegionFactory（单例模式，适合单应用）--youjiankuohaophpcn
- 实体类上标注缓存策略：
@Entity
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE) // 或 READ_ONLY, NONSTRICT_READ_WRITE
public class User { ... }
常见问题提醒
- 类名拼写错误（大小写、包名）、集合路径写成
User.roles而非com.example.User.roles→ 缓存不生效 - 忘记在实体类加
@Cache注解 → 即使配置了 cache name 也无效 - Ehcache jar 版本与 Hibernate 不匹配（如 Hibernate 4.3.x 应用 ehcache-core 2.6.x，不兼容 3.x）
- 未设置
hibernate.cache.use_second_level_cache=true→ 二级缓存被忽略
基本上就这些。配置不复杂但容易忽略细节，建议配完后通过日志（开启 org.hibernate.cache DEBUG）验证缓存命中情况。
