在 spring boot 中,当存在多个同类型的 bean 时,使用 @qualifier 可以指定具体的 bean 名称来注入。只需在 @autowired 或构造函数参数旁添加 @qualifier("beanname"),spring 容器就会根据名称精确匹配并注入对应的实例。

如何定义多个同类型 Bean 并使用 @Qualifier 进行字段注入
要演示这一过程,首先需要在配置类中定义两个相同接口的不同实现 Bean。接着,在目标组件中使用 @Autowired 配合 @Qualifier 指定其中一个 Bean 的名称。这样就能解决歧义,确保注入的是预期的实例。

import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.stereotype.Component;
@Component
public class MessageService {
private final MessageSender sender;
public MessageService(@Qualifier("emailSender") MessageSender sender) {
this.sender = sender;
}
}为什么 @Qualifier 必须与 @Autowired 配合使用
@Qualifier 本身不执行注入逻辑,它仅作为元数据提供候选 Bean 的名称。如果单独使用而不结合 @Autowired、@Inject 或构造器注入,Spring 不会自动完成依赖绑定。因此,必须将其放在注入点旁边,由注入机制读取该注解以缩小候选范围。

import javax.inject.Inject;
import javax.inject.Named;
@Named("smsSender")
public class SmsSender implements MessageSender {}
@Component
public class NotificationService {
private final MessageSender sender;
@Inject
public NotificationService(@Qualifier("smsSender") MessageSender sender) {
this.sender = sender;
}
}当 @Qualifier 指定的 Bean 不存在时会发生什么
如果 @Qualifier 中指定的名称在容器中找不到对应的 Bean,Spring 会在启动阶段抛出 NoUniqueBeanDefinitionException 或 NoMatchingBeanFoundException。这通常是因为拼写错误或 Bean 未被正确注册。此时应用无法启动,开发者需要检查 Bean 名称是否一致。


















