@Qualifier 用于在多个实现同一抽象类的 Bean 中明确指定注入目标，需确保子类被 Spring 管理为 Bean 并通过名称或自定义注解区分，抽象类本身不可直接注入。
在 Spring 中，@Qualifier 本身不能直接用于抽象类的子类选择——它作用于接口或抽象类的实现类（具体 Bean），而不是抽象类本身。关键在于：Spring 容器中必须存在多个实现了同一抽象类（或接口）的 Bean，且你需通过 @Qualifier 明确指定注入哪一个。
确保子类被 Spring 管理为 Bean
只有被 Spring 扫描并注册为 Bean 的具体子类，才能参与依赖注入和 @Qualifier 选择。
- 子类需加
@Component、@Service、@Repository等注解，或在配置类中用@Bean声明 - 抽象父类通常不加注解（也不应被实例化），仅作为类型声明使用
- 包扫描路径要覆盖子类所在位置
用 @Qualifier 配合自定义名称区分 Bean
当多个子类都注册为同一抽象类型（如 PaymentProcessor）的 Bean 时，可为每个 Bean 指定唯一名称，再用 @Qualifier("xxx") 注入。
例如：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
// 抽象类
public abstract class PaymentProcessor {
public abstract void process();
}
<p>// 子类 A
@Service("alipayProcessor")
public class AlipayProcessor extends PaymentProcessor {
public void process() { /<em> ... </em>/ }
}</p><p>// 子类 B
@Service("wechatProcessor")
public class WechatProcessor extends PaymentProcessor {
public void process() { /<em> ... </em>/ }
}</p><p>// 使用方
@Service
public class OrderService {
private final PaymentProcessor processor;</p><pre class="brush:php;toolbar:false;">public OrderService(@Qualifier("alipayProcessor") PaymentProcessor processor) {
this.processor = processor; // 注入 AlipayProcessor 实例
}}
配合 @Primary 或自定义 @Qualifier 注解更清晰
若某子类是默认首选，可用 @Primary 标记；若想语义化更强，可定义自定义限定符注解。
-
@Primary用在某个子类上，表示当未指定@Qualifier时默认选它 - 自定义注解（如
@Alipay）需加上@Qualifier元注解，然后在子类和注入点上对应使用，避免字符串硬编码
注意抽象类不能直接被 @Autowired（除非有且仅有一个子类 Bean）
Spring 不允许直接 @Autowired 抽象类类型，除非上下文中只存在一个匹配的子类 Bean（此时可省略 @Qualifier）。但这种“隐式唯一”不推荐用于多实现场景，易引发歧义或后续扩展问题。
一旦新增另一个子类 Bean 而未调整注入逻辑，就会报错：NoUniqueBeanDefinitionException。所以显式用 @Qualifier 是更安全、可维护的做法。
