Ehcache的ehcache.xml配置文件详解

ehcache.xml 是 EHCache 的核心配置文件，以 为根节点，包含 diskStore（磁盘路径）、defaultCache（默认策略，必设 maxElementsInMemory/eternal/overflowToDisk）、named cache（具名缓存，支持覆盖默认配置）及其他根属性如 updateCheck、dynamicConfig 等。

ehcache.xml 是 EHCache 的核心配置文件，决定缓存的存储方式、生命周期、淘汰策略和持久化行为。它采用标准 XML 格式，必须以为根节点，所有缓存策略均在此定义。

diskStore：磁盘缓存路径设置该元素指定缓存数据写入磁盘时的根目录，仅在启用磁盘缓存（如overflowToDisk="true"或diskPersistent="true"）时生效。

支持系统属性占位符，例如java.io.tmpdir、user.home、user.dir路径需有写权限；Windows 下建议用双反斜杠或正斜杠，如c:/ehcache或c:\ehcache若未配置，EHCache 默认使用java.io.tmpdir defaultCache：默认缓存策略当程序通过CacheManager.add("xxx")创建未显式声明的缓存时，将自动继承的配置。它是全局兜底策略，必须存在且至少包含必要属性。

Trae win Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。

下载maxElementsInMemory：内存中最多缓存多少个 Element，超出则触发淘汰（必填）

eternal：是否永不过期；设为true时，timeToIdleSeconds和timeToLiveSeconds将被忽略（必填）

overflowToDisk：内存满后是否溢出到磁盘（必填）

timeToIdleSeconds：元素空闲多久后过期（单位秒），仅对eternal="false"生效timeToLiveSeconds：元素创建后最长存活时间（单位秒），同样仅对eternal="false"生效memoryStoreEvictionPolicy：内存满时的淘汰策略，可选LRU（默认）、FIFO、LFU named cache：命名缓存实例针对不同业务场景（如用户信息、商品列表），可单独定义具名缓存，覆盖默认配置。每个必须有唯一name属性。

name 值会被 EHCache 内部用于注册到 CacheManager 的 Map 中，不可重复可复用 defaultCache 的全部属性，并额外支持：diskPersistent（JVM重启后是否恢复磁盘缓存）、diskExpiryThreadIntervalSeconds（磁盘过期清理线程执行间隔）、diskSpoolBufferSizeMB（单个缓存的磁盘缓冲区大小，默认30MB）

若某缓存不需磁盘能力，可设overflowToDisk="false"且省略diskStore配置其他关键配置项说明除上述结构外，根节点本身也支持若干控制性属性：updateCheck：是否检查新版本（设为false可避免启动时联网请求）

dynamicConfig：是否允许运行时动态修改配置（默认true；设为false后，代码调用 Configuration 修改将无效）

xsi:noNamespaceSchemaLocation：指向 ehcache.xsd 文件，用于 IDE 提供语法提示与校验（推荐使用在线地址http://ehcache.org/ehcache.xsd）