Redis报错：A bean with that name has already been defined in class path resource

沙白猿2026-01-11 12:20

1. 报错信息

Description:

The bean 'redisTemplate', defined in class path resource [xxx/xxx/xxx], could not be registered. A bean with that name has already been defined in class path resource [org/springframework/boot/autoconfigure/data/redis/RedisAutoConfiguration.class] and overriding is disabled.

Action:

Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true

2. 错误信息解析

由错误信息可以看出，redis报错，这个错误说：无法创建一个名字为redisTemplate的bean，原因是这个名字的bean已经存在了，再创建就会报错

3. 解决方案

怎么解决呢？其实spring框架已经告诉我们怎么解决，如高亮所示，让我们考虑加上注解：

复制代码

@ConditionalOnMissingBean(name = "redisTemplate")

注意：name的值需要看你的redis的配置config文件里面定义的redis的bean的名字，不一定和博主的name相同

这个注解的意思是：只有当没有同名的bean才会创建

java 复制代码

@Configuration
public class RedisConfig {
    
    @Bean
    @ConditionalOnMissingBean(name = "redisTemplate") // 只有当没有同名的 bean 时才创建
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(redisConnectionFactory);

        // 设置 key 的序列化器
        template.setKeySerializer(new StringRedisSerializer());
        template.setHashKeySerializer(new StringRedisSerializer());

        // 设置 value 的序列化器
        template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
        template.setHashValueSerializer(new GenericJackson2JsonRedisSerializer());

        template.afterPropertiesSet();
        return template;
    }
}