基于配置文件开关全局控制Spring Boot Redis缓存的启用与禁用

针对你需要通过外部配置开关全局控制Redis缓存，且cacheEnabled=true时禁用缓存的需求，以下是两种无需修改业务代码的可行方案：

方案一：通过条件注解完全禁用缓存机制 #

核心思路是控制@EnableCaching注解的生效与否，彻底关闭整个缓存体系，避免加载任何缓存相关Bean（包括Redis连接组件）。

实现步骤： #

1. 创建缓存配置类，用@ConditionalOnProperty反向匹配配置开关：

@Configuration
@EnableCaching
// 仅当cacheEnabled为false时才加载该配置（启用缓存），未配置时默认启用
@ConditionalOnProperty(name = "cacheEnabled", havingValue = "false", matchIfMissing = true)
public class RedisCacheConfig {

    // 这里添加你的Redis缓存核心配置，比如RedisConnectionFactory、CacheManager等
    @Bean
    public RedisCacheManager redisCacheManager(RedisConnectionFactory connectionFactory) {
        RedisCacheConfiguration cacheConfig = RedisCacheConfiguration.defaultCacheConfig()
                .serializeKeysWith(RedisSerializationContext.SerializationPair.fromSerializer(new StringRedisSerializer()))
                .serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(new GenericJackson2JsonRedisSerializer()));
        
        return RedisCacheManager.builder(connectionFactory)
                .cacheDefaults(cacheConfig)
                .build();
    }

    // 若需要单独控制Redis连接工厂，可给RedisConnectionFactory的Bean也添加相同条件注解
    @Bean
    public RedisConnectionFactory redisConnectionFactory() {
        LettuceConnectionFactory factory = new LettuceConnectionFactory();
        factory.setHostName("your-redis-host");
        factory.setPort(6379);
        return factory;
    }
}

2. 在外部配置文件中设置开关：

# application.yml
cacheEnabled: true  # 禁用缓存，缓存配置类不会加载，无Redis连接尝试
# cacheEnabled: false # 启用Redis缓存

方案二：替换为无操作缓存管理器（保留缓存注解逻辑） #

如果需要保留业务代码中的@Cacheable等注解，但实际不执行缓存操作（也不连接Redis），可以用NoOpCacheManager替代Redis缓存管理器。

实现步骤： #

1. 创建条件化缓存管理器配置：

@Configuration
@EnableCaching
public class CacheConfig {

    // 当cacheEnabled=true时，使用无操作缓存管理器，不做任何缓存
    @Bean
    @ConditionalOnProperty(name = "cacheEnabled", havingValue = "true")
    public CacheManager noOpCacheManager() {
        return new NoOpCacheManager();
    }

    // 当cacheEnabled=false时，启用Redis缓存管理器
    @Bean
    @ConditionalOnProperty(name = "cacheEnabled", havingValue = "false", matchIfMissing = true)
    public RedisCacheManager redisCacheManager(RedisConnectionFactory connectionFactory) {
        RedisCacheConfiguration cacheConfig = RedisCacheConfiguration.defaultCacheConfig()
                .serializeKeysWith(RedisSerializationContext.SerializationPair.fromSerializer(new StringRedisSerializer()))
                .serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(new GenericJackson2JsonRedisSerializer()));
        
        return RedisCacheManager.builder(connectionFactory)
                .cacheDefaults(cacheConfig)
                .build();
    }
}

2. 同样通过配置文件控制开关，效果是：

• cacheEnabled=true：所有缓存注解方法不会实际缓存数据，也不会尝试连接Redis，解决连接拒绝问题
• cacheEnabled=false：正常使用Redis缓存

为什么之前的SPEL方案不适用？ #

基于SPEL的方法级条件（如@Cacheable(condition = "#{!@environment.getProperty('cacheEnabled')}")）存在两个问题：

• 需要给每个缓存方法添加条件，无法全局统一控制，维护成本高
• 即使方法不缓存，Redis缓存管理器依然会初始化并尝试连接Redis，导致连接拒绝错误

以上两种方案均无需修改业务代码，仅通过外部配置即可全局控制缓存状态，完美匹配你的场景。

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