@Qualifier 用于解决@Autowired注入多个同类型Bean时的歧义问题，通过指定Bean名称或自定义限定符注解实现精准匹配，优先级高于@Primary。

@Qualifier 是 Spring 提供的用于解决“@Autowired 存在多个同类型 Bean 时无法确定注入哪一个”问题的关键注解。它本身不指定名称，而是配合自定义限定符或与 @Bean 的 name 属性（或类名）协同工作，实现按名称精准匹配。

明确 Bean 名称是前提

Spring 容器中每个 Bean 都有唯一名称（id）。默认情况下，使用 @Component 及其衍生注解（如 @Service、@Repository）时，首字母小写的类名即为 Bean 名称（例如 UserService 类 → Bean 名为 userService）。用 @Bean 方法注册时，可通过方法名或显式 name 属性指定：

• @Bean(name = "primaryUserDao") public UserDao userDao() { ... }
• @Bean public UserDao secondaryUserDao() { ... } → Bean 名为 secondaryUserDao

用 @Qualifier 指定具体 Bean 名称

在字段或构造器参数上，用 @Qualifier("xxx") 显式声明要注入的 Bean 名：

• @Autowired @Qualifier("primaryUserDao") private UserDao userDao;
• 构造器注入也一样：public UserService(@Qualifier("secondaryUserDao") UserDao userDao) { ... }

此时 Spring 会忽略类型匹配的其他候选 Bean，只查找名称为 primaryUserDao 的那个实例。

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

立即学习“Java免费学习笔记（深入）”；

更推荐：自定义限定符注解（类型安全 + 语义清晰）

硬编码字符串易出错且无编译检查。建议定义专用的限定符注解：

• 创建注解：@Target({ElementType.FIELD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @Qualifier public @interface Primary {}
• 标注目标 Bean：@Primary @Primary UserDao primaryUserDao() { ... } 或更规范地：@Primary @Bean public UserDao primaryUserDao() { ... }
• 注入时使用：@Autowired @Primary private UserDao userDao;

这样既避免字符串拼写错误，又让意图一目了然，还能支持 IDE 自动补全和重构。

注意与 @Primary 的区别

@Primary 是“默认首选”，当没加 @Qualifier 时起作用；而 @Qualifier 是“强制指定”，优先级更高，会覆盖 @Primary。两者可共存，但语义不同：

• 多个 UserDao Bean 中只有一个标了 @Primary → 不加 @Qualifier 时自动选它
• 加了 @Qualifier("xxx") → 无论有没有 @Primary，都只认名字叫 xxx 的那个