Spring Boot 3 移除了对 EhCacheCacheManager 的原生支持，需改用 JCacheCacheManager + 编程式 EhCache 3 配置，避免 javax.xml.bind 类缺失导致的 NoClassDefFoundError。
spring boot 3 移除了对 `ehcachecachemanager` 的原生支持，需改用 `jcachecachemanager` + 编程式 ehcache 3 配置，避免 `javax.xml.bind` 类缺失导致的 `noclassdeffounderror`。
在 Spring Boot 3 中，由于 JDK 11+ 已移除 JAXB（javax.xml.bind.*）模块，而 EhCache 3.10.x 的 XML 解析器仍依赖 ValidationEventHandler 等 JAXB 类，直接使用 ehcache.xml 会导致启动失败：java.lang.NoClassDefFoundError: javax/xml/bind/ValidationEventHandler。这不是配置文件语法错误，而是架构兼容性问题——Spring Boot 3 默认基于 Jakarta EE 9+（包名从 javax.* 迁移至 jakarta.*），且不再默认包含 JAXB。
因此，推荐放弃 ehcache.xml 声明式配置，改用纯 Java 编程式构建 EhCache 3 配置，完全绕过 XML 解析环节。以下是完整、可落地的解决方案：
✅ 正确依赖（Maven）
确保引入以下两个核心依赖（注意：无需额外添加 jaxb-api 或 jackson-dataformat-xml 等“补丁”依赖）：
<dependency><groupid>org.springframework.boot</groupid><artifactid>spring-boot-starter-cache</artifactid></dependency><dependency><groupid>org.ehcache</groupid><artifactid>ehcache</artifactid><!-- Spring Boot 3 兼容的最新稳定版 --><version>3.10.8</version></dependency>
✅ Java 配置类（推荐方式）
import org.ehcache.config.CacheConfiguration;
import org.ehcache.config.builders.CacheConfigurationBuilder;
import org.ehcache.config.builders.ExpiryPolicyBuilder;
import org.ehcache.config.builders.ResourcePoolsBuilder;
import org.ehcache.config.units.MemoryUnit;
import org.ehcache.core.config.DefaultConfiguration;
import org.ehcache.expiry.ExpiryPolicy;
import org.ehcache.jsr107.EhcacheCachingProvider;
import org.springframework.cache.CacheManager;
import org.springframework.cache.annotation.EnableCaching;
import org.springframework.cache.jcache.JCacheCacheManager;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import javax.cache.Caching;
import java.time.Duration;
import java.util.HashMap;
import java.util.Map;
@Configuration
@EnableCaching
public class CachingConfig {
private static final String MY_CACHE = "myCache";
@Bean
public CacheManager jCacheCacheManager() {
// 1. 定义缓存资源池（heap + off-heap）
ResourcePoolsBuilder pools = ResourcePoolsBuilder
.heap(20, MemoryUnit.ENTRIES) // 最多 20 条记录（推荐单位）
.offheap(10, MemoryUnit.MB); // 可选：启用堆外内存
// 2. 定义过期策略：TTL=60分钟，TTI=30分钟（访问后重置）
ExpiryPolicy<object object> expiry = ExpiryPolicyBuilder
.expiry()
.create(Duration.ofMinutes(60))
.access(Duration.ofMinutes(30))
.build();
// 3. 构建缓存配置
CacheConfiguration<object object> config = CacheConfigurationBuilder
.newCacheConfigurationBuilder(Object.class, Object.class, pools)
.withExpiry(expiry)
.build();
// 4. 初始化 JSR-107 CacheManager
Map<string cacheconfiguration>> cacheConfigs = new HashMap();
cacheConfigs.put(MY_CACHE, config);
EhcacheCachingProvider provider = (EhcacheCachingProvider)
Caching.getCachingProvider(EhcacheCachingProvider.class.getName());
DefaultConfiguration defaultConfig = new DefaultConfiguration(
cacheConfigs,
provider.getDefaultClassLoader()
);
javax.cache.CacheManager cacheManager = provider.getCacheManager(
provider.getDefaultURI(),
defaultConfig
);
return new JCacheCacheManager(cacheManager);
}
}</string></object></object>
⚠️ 关键注意事项
-
禁用
ehcache.xml：删除src/main/resources/ehcache.xml，否则可能触发冲突或静默忽略； -
缓存名称一致性：
@Cacheable(value = "myCache")中的value必须与cacheConfigs.put("myCache", ...)中的 key 完全一致（区分大小写）； -
类型安全建议：生产环境应将
Object.class替换为具体 Key/Value 类型（如String.class,User.class）； -
资源限制调优：
heap(20, ENTRIES)更适合小规模缓存；若需更大容量，建议改用heap(512, MB)并监控 GC； -
替代方案：如坚持 XML 配置，需强制引入 JAXB（不推荐）：
<dependency><groupid>jakarta.xml.bind</groupid><artifactid>jakarta.xml.bind-api</artifactid></dependency><dependency><groupid>org.glassfish.jaxb</groupid><artifactid>jaxb-runtime</artifactid></dependency>
但此方式增加依赖复杂度，且无法解决 Jakarta EE 包名迁移带来的潜在兼容风险。
✅ 验证缓存生效
在任意 Service 方法上添加注解即可使用：
@Service
public class UserService {
@Cacheable(value = "myCache", key = "#id")
public User findById(Long id) {
// 实际数据库查询逻辑
return userRepository.findById(id).orElse(null);
}
}
通过上述配置，你将获得一个零 XML、零 JAXB 依赖、完全兼容 Spring Boot 3 和 JDK 17+ 的高性能 EhCache 3 缓存方案。
