SpringBoot拒绝使用自定义RedisCacheManager问题求助

问题描述 #

我最近碰到了一个Redis相关的棘手问题：明明已经创建了自定义的RedisCacheManager Bean，还特意加上了@Bean和@Primary注解，但SpringBoot就是不肯用它，反而一直使用默认生成的通用CacheManager。这直接导致我在自定义CacheManager里配置的JsonSerializer完全没生效，从堆栈跟踪里能明确看到SpringBoot一直在用DefaultSerializer。另外我怀疑可能和MainApplication类的扫描范围有关，但还没排查出具体问题。

解决方案建议 #

你可以从以下几个方向逐一排查和尝试解决：

• 排除Redis缓存自动配置类
  SpringBoot的RedisCacheAutoConfiguration会自动创建默认的RedisCacheManager，很可能它的优先级覆盖了你的自定义Bean。你可以在主启动类上排除这个自动配置类，同时务必加上@EnableCaching（这个注解是开启Spring缓存功能的关键，没加的话自定义CacheManager也不会生效）：

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

• 确认自定义配置类的扫描有效性
  检查你的自定义Redis配置类（定义RedisCacheManager Bean的类）是否被Spring正确扫描到：

  • 配置类上必须添加@Configuration注解
  • 如果配置类不在MainApplication所在包或其子包下，要在主启动类上用@ComponentScan指定扫描路径，比如@ComponentScan(basePackages = {"com.your.main.package", "com.your.config.package"})

• 检查@Primary注解的唯一性
  确保你的项目里没有其他CacheManager类型的Bean也标记了@Primary，如果有多个同类型的@Primary Bean，Spring会无法确定优先级，最终可能还是走默认逻辑。

• 验证自定义Bean是否被实例化
  在自定义RedisCacheManager的Bean方法里加个日志或者打印语句，启动项目时看是否输出，以此确认Spring有没有真的创建这个Bean：

  @Configuration
  @EnableCaching
  public class RedisConfig {
      @Bean
      @Primary
      public RedisCacheManager redisCacheManager(RedisConnectionFactory redisConnectionFactory) {
          // 配置Json序列化
          RedisCacheConfiguration cacheConfig = RedisCacheConfiguration.defaultCacheConfig()
                  .serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(new GenericJackson2JsonRedisSerializer()));
          
          // 加打印语句确认Bean初始化
          System.out.println("自定义RedisCacheManager已成功初始化");
          
          return RedisCacheManager.builder(redisConnectionFactory)
                  .cacheDefaults(cacheConfig)
                  .build();
      }
  }
  

  如果启动时没看到这个打印内容，说明你的配置类根本没被Spring加载，就要回头重点检查扫描范围和类上的注解配置。

• 检查缓存注解的使用规范
  确保你在业务方法上用的是Spring标准的缓存注解（比如@Cacheable、@CachePut等），而且这些方法所在的类被Spring管理（加了@Service、@Component等注解）。

备注：内容来源于stack exchange，提问作者Brown Niqqar