当Spring容器存在多个同类型Bean时，@Autowired需配合@Qualifier通过Bean名称或自定义限定符精准注入；可显式命名Bean或定义语义化限定注解；@Qualifier优先级高于@Primary，二者可共存。

当 Spring 容器中存在多个相同类型的 Bean 时，@Autowired 无法确定该注入哪一个，这时就需要 @Qualifier 配合使用，通过 Bean 的名称（或自定义限定符）来精准指定目标 Bean。

用 Bean 名称配合 @Qualifier

Spring 默认将类名首字母小写作为 Bean 名称（如 UserServiceImpl → userServiceImpl），也可用 @Component("xxx") 显式指定。在注入处用 @Qualifier("xxx") 即可匹配：

• 确保目标 Bean 已被 Spring 管理（加了 @Component、@Service 等注解）
• 注入字段或构造方法参数上，同时标注 @Autowired 和 @Qualifier("beanName")
• 名称必须与容器中注册的 Bean 名称完全一致（区分大小写）

用自定义 @Qualifier 注解实现语义化限定

硬编码字符串易出错且不直观，推荐定义专用的限定符注解：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 新建注解，加上 @Qualifier 元注解，例如：
  

  @Target({ElementType.FIELD, ElementType.PARAMETER})<br>@Retention(RetentionPolicy.RUNTIME)<br>@Qualifier<br>public @interface PrimaryUserDao {}

• 在具体 Bean 类上添加该注解：@PrimaryUserDao @Repository public class JdbcUserDao implements UserDao { ... }
• 注入时直接使用：@Autowired @PrimaryUserDao private UserDao userDao;

@Primary 与 @Qualifier 的关系

@Primary 是一种“默认优选”机制，当只有一个 @Primary Bean 且没用 @Qualifier 时，Spring 会自动选它；但一旦用了 @Qualifier，就以限定符为准，@Primary 不再起作用。

• 多个同类型 Bean 中，最多只能有一个标 @Primary
• @Qualifier 优先级高于 @Primary
• 二者可共存：比如一个主实现加 @Primary，其他实现用自定义 @Qualifier 区分

常见问题提醒

使用 @Qualifier 时要注意：

• 不能只写 @Qualifier 而不写 @Autowired（除非用在构造方法且类只有一个构造器，Spring 5.3+ 支持隐式装配）
• 若限定符注解未被任何 Bean 标记，启动时抛出 NoUniqueBeanDefinitionException
• 构造器注入时，@Qualifier 要加在参数上，不是构造器上