Spring Boot默认缓存与GemFire缓存混用 如何指定不同场景使用对应缓存

Spring缓存抽象默认使用容器中优先级最高的CacheManager实现作为全局默认实例。引入GemFire依赖后，Spring Boot的自动配置逻辑会将GemFire对应的CacheManager注册为默认实现，因此所有未显式指定缓存管理器的@Cacheable方法都会优先从GemFire中查询数据，导致原有缓存逻辑被覆盖。

方案1：显式绑定缓存管理器（最常用，改造成本最低） #

• 先在配置类中分别声明原有缓存、GemFire缓存的两个CacheManager Bean，给不同Bean分配唯一标识
• 给原有常用的缓存管理器添加@Primary注解设为全局默认，原有未指定缓存管理器的业务代码无需修改，自动沿用原有缓存逻辑
• 需要使用GemFire的业务方法，在@Cacheable注解中通过cacheManager属性指定对应的Bean名称即可

配置示例：

@Configuration
public class MultiCacheConfig {
    // 原有业务默认缓存（示例为Caffeine实现，可替换为你之前使用的缓存类型）
    @Bean
    @Primary
    public CacheManager defaultCacheManager() {
        CaffeineCacheManager caffeineCacheManager = new CaffeineCacheManager();
        // 配置原有缓存空间、过期规则等
        caffeineCacheManager.setCacheNames(Arrays.asList("userCache", "orderCache"));
        return caffeineCacheManager;
    }

    // GemFire专用缓存管理器
    @Bean
    public CacheManager gemfireCacheManager(GemFireCache gemfireCache) {
        GemfireCacheManager gemfireCacheManager = new GemfireCacheManager();
        gemfireCacheManager.setCache(gemfireCache);
        return gemfireCacheManager;
    }
}

GemFire缓存使用示例：

// 显式指定使用GemFire缓存管理器
@Cacheable(value = "newBusinessCache", cacheManager = "gemfireCacheManager")
public Object getNewBusinessData(String id) {
    // 业务查询逻辑
}

方案2：自定义CacheResolver实现动态路由 #

如果缓存选择逻辑比较复杂（比如根据缓存名前缀、方法参数、环境变量动态判断缓存源），可以实现自定义CacheResolver接口，统一管控所有缓存请求的路由规则，避免每个方法都手动指定cacheManager属性。

方案3：缓存名称分区隔离 #

提前约定缓存命名规则，比如GemFire存储的缓存名称统一加gemfire_前缀，原有缓存名称不加前缀，配合自定义CacheResolver自动根据前缀匹配对应的CacheManager，无需在业务代码中额外配置。

• 接入多缓存源时必须显式指定@Primary默认缓存管理器，不要依赖Spring Boot的自动优先级判断，避免升级依赖时出现非预期的缓存切换
• 不同业务域的缓存空间做明确的命名隔离，避免不同缓存源之间出现缓存名称冲突，导致数据读写异常
• 核心业务的缓存逻辑建议显式指定cacheManager属性，不要依赖默认绑定，提升代码的可读性和可维护性
• 所有缓存规则、配置集中在统一的配置类中管理，不要分散在各个业务类中，方便后续缓存源的切换和规则调整
• 新增缓存源上线前必须回归验证原有缓存逻辑的读写、过期、淘汰规则是否符合预期，避免出现缓存击穿、数据不一致等线上问题

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