Spring Java多模块下多CacheManager配置实现方案求助

嗨，这个问题我之前帮好几个开发者解决过，核心原因其实是Spring容器里现在存在多个CacheManager实例，它没办法自动确定该用哪一个作为默认的，所以启动时会抛出类似NoUniqueBeanDefinitionException的异常。下面给你分步骤说清楚怎么解决：

1. 标记默认CacheManager（快速解决冲突） #

如果你的其中一个CacheManager需要作为全局默认选项，只需要在对应的配置类的@Bean方法上加上@Primary注解，告诉Spring优先使用这个实例。

比如你想让Project A的CacheManager作为默认：

@Configuration
@EnableCaching
public class ProjectACacheConfig {

    @Primary // 明确标记为默认CacheManager
    @Bean(name = "projectACacheManager")
    public CacheManager projectACacheManager() {
        // 这里配置A模块的缓存实现，比如Redis/Caffeine等
        CaffeineCacheManager cacheManager = new CaffeineCacheManager();
        cacheManager.setCaffeine(Caffeine.newBuilder().expireAfterWrite(10, TimeUnit.MINUTES));
        return cacheManager;
    }
}

Project B的原有CacheManager配置保持不变即可，不需要额外修改。反之，如果想让B的作为默认，就在B的CacheManager Bean上加@Primary。

2. 命名区分+指定使用（更灵活的方案） #

如果两个模块的CacheManager都需要独立使用，不需要默认值，那给每个CacheManager的Bean指定唯一名称，然后在业务代码中明确指定要使用的缓存管理器。

第一步：给两个CacheManager命名 #

Project B的配置：

@Configuration
@EnableCaching
public class ProjectBCacheConfig {

    @Bean(name = "projectBCacheManager")
    public CacheManager projectBCacheManager(RedisConnectionFactory connectionFactory) {
        // B模块原有的Redis缓存配置
        return RedisCacheManager.builder(connectionFactory).build();
    }
}

Project A的配置：

@Configuration
@EnableCaching
public class ProjectACacheConfig {

    @Bean(name = "projectACacheManager")
    public CacheManager projectACacheManager() {
        // A模块的本地缓存配置
        return new CaffeineCacheManager("userCache", "orderCache");
    }
}

第二步：使用时指定CacheManager #

在业务方法上通过@Cacheable的cacheManager属性指定要用到的实例：

// 使用A模块的缓存
@Cacheable(value = "userCache", cacheManager = "projectACacheManager")
public User getUserById(Long userId) {
    // 数据库查询逻辑
    return userMapper.selectById(userId);
}

// 使用B模块的缓存
@Cacheable(value = "productCache", cacheManager = "projectBCacheManager")
public Product getProductById(Long productId) {
    // 数据库查询逻辑
    return productMapper.selectById(productId);
}

3. 排除自动配置的CacheManager（可选） #

如果某个模块的CacheManager是Spring Boot自动配置生成的，你可以在Project A的启动类上排除对应的自动配置类，避免冲突：

@SpringBootApplication(exclude = RedisCacheAutoConfiguration.class) // 举例排除Redis自动缓存配置
public class ProjectAApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProjectAApplication.class, args);
    }
}

这个方案适合你完全不需要该自动缓存配置的场景。

额外注意点 #

• 确保两个模块的配置类都被Spring扫描到，比如检查@ComponentScan是否包含了对应模块的包路径；
• 如果用了Spring Boot的配置文件（application.yml/application.properties），注意不要有全局缓存配置覆盖了自定义Bean的行为。

内容的提问来源于stack exchange，提问作者it'sme