@autowired默认按类型注入，当存在多个同类型bean时会抛出nouniquebeandefinitionexception；解决方法是用@primary指定默认bean，或配合@qualifier精准指定bean名称，二者可协同使用以兼顾默认性与灵活性。

当一个接口有多个实现类，Spring 容器里存在多个同类型的 Bean 时，@Autowired 默认按类型注入会失败，抛出 NoUniqueBeanDefinitionException。解决这类冲突，核心靠两个注解配合使用：@Primary 定义默认选择，@Qualifier 实现精准指定。

什么时候用 @Primary？

当你希望某个实现类成为“多数情况下的默认注入目标”，且不希望每个注入点都写限定符时，就用 @Primary。

• 加在实现类上（配合 @Service、@Component 等）或 @Bean 方法上
• 它只影响“未显式指定 Bean 名称”的注入场景，比如：@Autowired private SmsService service;
• 如果同时存在多个 @Primary，Spring 启动会报错，必须且只能有一个
• 适合主备切换中的“主”、策略模式里的“默认策略”等稳定优先级场景

什么时候用 @Qualifier？

当你需要在具体位置明确选中某一个 Bean，尤其是不同调用点要注入不同实现时，必须用 @Qualifier。

Java Linux版

Java Linux版下载入口，提供 Oracle JDK 26.0.2 官方 Linux 安装包、Java 环境配置、JDBC 数据库连接和 Java 服务端开发相关信息。

下载

• 必须和 @Autowired 搭配使用，写在字段、构造器参数或 setter 上
• 括号里的字符串必须严格匹配 Bean 的 ID：比如 @Component("alipayService")，注入时就得写 @Qualifier("alipayService")
• 支持自定义限定符注解（如 @CreditCard），避免硬编码字符串，更安全可维护
• 它的优先级高于 @Primary：即使某个 Bean 被标记为 @Primary，只要注入点写了 @Qualifier("xxx")，就会以该名称为准

@Primary 和 @Qualifier 能一起用吗？

完全可以，而且这是推荐的组合策略——兼顾默认性与灵活性。

• 例如：支付服务有 AlipayService 和 WechatService，日常订单走支付宝，所以给 AlipayService 加 @Primary
• 但营销活动要临时切微信支付，就在对应 Service 构造器中写：@Qualifier("wechatService") PaymentService service
• 这样既保证了大多数地方免配置，又保留了按需切换的能力
• 注意：不要在同一个注入点既依赖字段名巧合匹配，又加 @Qualifier，容易造成行为不可控

还有没有其他可行方案？

有，但不如上面两种主流和清晰：

• @Resource(name = "xxx")：JDK 标准注解，按名称注入，不依赖 Spring，但需引入 jakarta.annotation-api 依赖
• 重命名 Bean + 字段名对齐：比如字段叫 wechatService，对应实现类注册为 @Service("wechatService")，属于隐式 byName 匹配，不推荐——不可靠，易受重构影响
• 排除自动配置或手动控制 Bean 注册：适用于多数据源等基础设施层，但业务逻辑层一般不这么做

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南