多态是Spring中@Qualifier生效的前提，二者为协作关系：多态提供同一类型多种实现的结构基础，@Qualifier在容器中精准选择具体实现；需定义公共父类型、至少两个被管理的子类Bean及唯一标识。
Java 多态本身是语言特性，Spring 的 @Qualifier 是框架级的依赖注入辅助机制——二者不是替代关系，而是协作关系：多态提供“同一类型、多种实现”的结构基础，@Qualifier 则在 Spring 容器中精准选择某一个具体实现。
多态是前提，Qualifier 是选择器
没有多个实现类（即多态结构），@Qualifier 就无用武之地。Spring 要求：
- 定义一个公共父类型（接口或抽象类）作为注入点类型
- 至少两个具体子类被 Spring 管理为 Bean（如加
@Service、@Component） - 每个子类需有唯一标识（默认类名小写，或显式指定名称）
三种常用配合方式
1. 按 Bean 名称注入（最直接）
给每个实现类指定明确名称，注入时用 @Qualifier("xxx") 指向它：
@Service("alipay")
public class AlipayPayment implements PaymentService { ... }
@Service("wechat")
public class WechatPayment implements PaymentService { ... }
@Service
public class OrderService {
private final PaymentService paymentService;
public OrderService(@Qualifier("wechat") PaymentService paymentService) {
this.paymentService = paymentService; // 明确选微信支付
}
}
2. 用 @Primary 设默认实现
当多数场景用某一个实现时，标记它为首选：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 在某个实现类上加
@Primary（如@Service @Primary） - 不加
@Qualifier时自动注入该 Bean - 仍可用
@Qualifier覆盖默认选择
3. 自定义限定符注解（更安全、可读性更强）
避免字符串硬编码，语义化更清晰：
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Qualifier
public @interface Alipay { }
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Qualifier
public @interface Wechat { }
@Service
@Alipay
public class AlipayPayment implements PaymentService { ... }
@Service
@Wechat
public class WechatPayment implements PaymentService { ... }
@Service
public class OrderService {
private final PaymentService paymentService;
public OrderService(@Alipay PaymentService paymentService) {
this.paymentService = paymentService; // 编译期检查，不怕拼错
}
}
进阶技巧：批量获取所有实现
不只限于单个注入，多态结构还可配合容器能力动态使用：
- 用
@Autowired Map<String, PaymentService>获取所有实现，key 是 Bean 名称 - 用
@Autowired List<PaymentService>获取全部实例，适合策略路由或广播调用 - 结合工厂类或策略上下文（如根据订单类型查 Map 中对应 Bean）
常见踩坑提醒
抽象类本身不能加 @Service 或 @Component
它只是类型声明，Spring 不会实例化它。只有具体子类才能注册为 Bean。
包扫描必须覆盖子类路径
如果子类不在 @ComponentScan 范围内，Spring 根本看不到它们，@Qualifier 也就失效。
构造器注入优于字段注入
推荐在构造函数参数上用 @Qualifier，保证依赖不可变且测试友好。
