spring boot自动配置与自定义redis配置类冲突，是因为二者均注册同类型bean（如redistemplate），导致nouniquebeandefinitionexception；@primary指定默认bean但有覆盖风险，@qualifier配合@bean命名可精准注入，避免冲突。
Spring Boot自动配置和自定义Redis配置类为什么会冲突
Spring Boot 2.0+ 默认通过 RedisAutoConfiguration 注册了 RedisTemplate 和 StringRedisTemplate 的 Bean。当你自己写了一个 @Configuration 类并声明了同类型的 Bean（比如另一个 RedisTemplate），Spring 容器就会报 NoUniqueBeanDefinitionException：找到多个 RedisTemplate 实例，无法决定注入哪一个。
@Primary 注解能解决什么，又有什么风险
@Primary 告诉 Spring：当有多个同类型 Bean 时，优先选这个。它简单直接，但只适用于“全局默认用我这个”的场景。
- 如果你的项目里所有地方都该用你定制的
RedisTemplate（比如统一用了GenericJackson2JsonRedisSerializer），加@Primary是安全且省事的 - 如果部分模块需要 String-only 操作（比如用
StringRedisTemplate做缓存键管理），而你把@Primary错加在了泛型RedisTemplate<object object></object>上，可能导致StringRedisTemplate被意外覆盖或注入失败 -
@Primary只能标在一个 Bean 上；如果之后引入第三方 Starter 也声明了@Primary的 Redis 相关 Bean，启动会直接失败
@Qualifier 配合 @Autowired 才是精准控制的关键
比起全局设默认，更推荐显式指定要哪个 Bean——用 @Qualifier 绑定名字，再配合 @Autowired 注入。这样每个使用点都清楚自己依赖的是哪个实例。
实操建议：
- 给自定义
RedisTemplate显式命名：@Bean("myRedisTemplate") - 注入时写明：
@Autowired @Qualifier("myRedisTemplate") private RedisTemplate<string object> redisTemplate;</string> - 保持 Spring Boot 原生的
StringRedisTemplate不受影响，它默认 bean name 是stringRedisTemplate，可继续用@Qualifier("stringRedisTemplate")注入 - 避免在配置类里对同一个类型反复声明多个
@Bean方法却不加 name 或@Primary，这是冲突高发源头
常见错误现象和快速定位方法
启动报错典型信息：Field redisTemplate in xxx required a single bean, but 2 were found 或 Could not resolve placeholder 'spring.redis.host' in value "${spring.redis.host}"（说明自定义配置类干扰了自动配置的属性绑定）。
排查要点：
- 检查是否在自定义
@Configuration类中重复@EnableConfigurationProperties(RedisProperties.class)—— Spring Boot 已自动做了，手动加会导致属性加载异常 - 确认自定义
RedisConnectionFactory是否也用了@Primary；如果连连接工厂都标了@Primary，可能让StringRedisTemplate初始化失败 - 用
ApplicationContext.getBeanNamesForType(RedisTemplate.class)在启动后打印所有注册的RedisTemplate名字，验证实际注册了几个、叫什么名
@Primary 和 @Qualifier 不是互斥方案，而是不同粒度的控制手段——前者管“默认选谁”，后者管“这里明确要谁”。混用时务必确保 bean name 唯一、语义清晰，否则调试时连日志都看不出哪个 Bean 被注入了。
