Spring Boot中CacheManager Bean实例化失败问题及解决咨询

核心原因 #

出现该错误是因为Spring Boot未自动创建CacheManager类型的Bean，这需要满足两个前提：开启缓存功能，以及提供EhCache的配置（自动或手动方式）。

解决方案 #

1. 开启缓存支持 #

在Spring Boot启动类或任意@Configuration类上添加@EnableCaching注解，这是激活Spring缓存功能的必要开关：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cache.annotation.EnableCaching;

@SpringBootApplication
@EnableCaching
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 方式一：自动配置（推荐） #

Spring Boot支持自动配置EhCache，只需在src/main/resources下创建标准的EhCache配置文件ehcache.xml，示例配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="http://www.ehcache.org/ehcache.xsd">
    <!-- 可根据业务需求调整缓存参数 -->
    <cache name="businessCache"
           maxEntriesLocalHeap="1000"
           timeToLiveSeconds="7200"
           memoryStoreEvictionPolicy="LRU">
    </cache>
</config>

添加配置文件后，Spring Boot会自动识别并创建EhCacheCacheManager Bean，无需手动编写配置类。

3. 方式二：手动配置Bean（匹配你的思路） #

如果需要自定义CacheManager的创建逻辑，可编写@Configuration类手动声明Bean：

import org.springframework.cache.annotation.EnableCaching;
import org.springframework.cache.ehcache.EhCacheCacheManager;
import org.springframework.cache.ehcache.EhCacheManagerFactoryBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.ClassPathResource;

@Configuration
@EnableCaching
public class CacheConfig {

    // 加载EhCache配置文件
    @Bean
    public EhCacheManagerFactoryBean ehCacheManagerFactory() {
        EhCacheManagerFactoryBean factoryBean = new EhCacheManagerFactoryBean();
        factoryBean.setConfigLocation(new ClassPathResource("ehcache.xml"));
        // 设置共享模式，避免重复创建缓存管理器实例
        factoryBean.setShared(true);
        return factoryBean;
    }

    // 声明Spring标准的CacheManager Bean
    @Bean
    public CacheManager cacheManager() {
        return new EhCacheCacheManager(ehCacheManagerFactory().getObject());
    }
}

4. 依赖检查 #

确认build.gradle的依赖配置正确，建议让Spring Boot管理EhCache版本，避免版本冲突：

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-cache'
    implementation 'org.ehcache:ehcache'
}

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