@Qualifier核心是显式指定Bean唯一标识符，使容器跳过按类型匹配的歧义阶段、直接按名注入；需配合@Autowired使用，且字符串必须严格匹配注册ID，支持自定义限定符提升可维护性。
Spring 使用 @Qualifier 解决按名称注入冲突，核心是**显式指定 Bean 的唯一标识符**，让容器跳过“按类型模糊匹配”的歧义阶段，直接按名锁定目标实例。它不改变注入方式（仍是 DI 容器行为），而是提供精准寻址能力。
明确注册 Bean 名称
注入能“按名”生效的前提，是目标 Bean 在容器中确实拥有可识别、可引用的名称：
- 用
@Component("alipayService")、@Service("wechatService")等 stereotype 注解显式声明 ID，最直观可靠 - 若只写
@Service不带参数，Spring 默认以类名首字母小写作为 Bean 名（如WechatService→wechatService），但重构类名时易出错，不建议依赖 - 在
@Bean方法上，用@Bean("dataSourcePrimary")明确命名，适用于配置类中手动定义的 Bean
在注入点绑定对应名称
@Qualifier 必须与 @Autowired 配合使用，且括号内字符串必须与注册时的 Bean 名完全一致（大小写敏感）：
- 字段注入：
@Autowired @Qualifier("alipayService") private PaymentService service; - 构造器注入（推荐）：
public OrderService(@Qualifier("wechatService") PaymentService service) - Setter 方法注入：
@Autowired public void setPaymentService(@Qualifier("alipayService") PaymentService service)
避免靠字段名“碰巧”匹配
例如字段名为 wechatService，而恰好存在同名 Bean，此时 Spring 可能注入成功——但这属于隐式 byName 行为，不是 @Qualifier 的作用，也不稳定：
- 一旦字段重命名，注入就会失败或错配
- 没有编译期检查，运行时报错才暴露问题
- 违背显式契约原则，团队协作和维护成本高
用自定义限定符提升可维护性
硬编码字符串易拼错、难检索。可定义语义化注解替代：
- 声明：
@Target({FIELD, PARAMETER}) @Retention(RUNTIME) @Qualifier public @interface Alipay {} - 标记实现类：
@Service @Alipay public class AlipayService implements PaymentService - 注入时使用：
@Autowired @Alipay private PaymentService service; - 好处：IDE 可导航、编译检查、重构安全、语义清晰
