当接口有多个实现类时，@autowired按类型注入会因bean不唯一而失败；应配合使用@primary设默认bean和@qualifier精准指定，前者标记唯一首选项，后者在注入点强制选择，二者协同实现默认+按需切换。
当一个接口有多个实现类，Spring 容器里存在多个同类型 Bean 时，@Autowired 按类型注入会失败，抛出 NoUniqueBeanDefinitionException。核心解法是用 @Primary 设定默认项，再用 @Qualifier 实现按需覆盖——两者配合，既简洁又可控。
@Primary：设一个“默认首选”
它告诉 Spring：“没特别说明时，就选我”。只加在 Bean 定义处（如 @Service 类或 @Bean 方法上），不写在注入点。
- 必须且只能有一个
@Primary，否则启动报错 - 只对未显式指定名称的注入生效，比如
@Autowired private SmsService service; - 适合主备场景（如生产用 MySQL Repository，开发用内存版）、策略模式中的默认策略
@Qualifier：精准指定具体 Bean
它写在注入点上，强制指定要哪个 Bean，字符串值必须严格匹配 Bean 名（ID）。
- 必须和
@Autowired搭配使用，可放在字段、构造器参数或 setter 上 - 优先级高于
@Primary：哪怕某个 Bean 被标为@Primary，只要写了@Qualifier("xxx")，就一定注入那个 - 推荐用自定义限定符注解（如
@Alipay），避免硬编码字符串，提升类型安全和可维护性
二者协同：默认 + 灵活切换
这是最实用的组合方式。日常走默认，特殊逻辑按需切。
- 例如支付服务：给
AlipayPaymentService加@Primary，多数地方直接@Autowired PaymentService即可 - 营销活动需要微信支付？在对应 Service 构造器中写
@Qualifier("wechatPaymentService") PaymentService service - 避免混用：不要同时依赖字段名巧合匹配（如字段叫
aliyunSmsService）又加@Qualifier，行为不可控
其他可行但不推荐的方案
不是不能用，只是清晰度或可维护性不如前两者。
-
@Resource(name = "xxx")：JDK 标准注解，按名称注入，不依赖 Spring，但需额外引入jakarta.annotation-api - 靠字段名隐式匹配：把字段命名为
wechatPaymentService，对应实现类注册为@Service("wechatPaymentService")。这种方式脆弱，重命名或重构易出错
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
