Spring 框架中，当一个接口有多个实现类时，获取这些 Bean 的集合或选择特定实现是一个常见且核心的需求。其背后的原理深度集成了 Spring 的控制反转（IoC）和依赖注入（DI）容器机制。
📦 一、整体获取方法
Spring 提供了多种优雅的方式来处理接口的多实现。
1. 集合注入（最常用、最推荐）
Spring 会自动将所有实现该接口的 Bean 收集到一个 Collection（如 List 或 Set）或 Map 中注入。
-
注入 List 或 Set：按 Bean 定义的顺序（或 @Order 注解）注入所有实现。
@Service
public class ClientService {
// 注入所有 PaymentService 实现
@Autowired
private List<PaymentService> allPaymentServices; // 或 Set<PaymentService>public void processAll() {
allPaymentServices.forEach(PaymentService::pay);
}
}// 定义接口和多个实现
public interface PaymentService { void pay(); }@Service("alipay") @Primary
public class AlipayService implements PaymentService { ... }@Service("wechatPay")
@Order(1) // 可定义顺序
public class WechatPayService implements PaymentService { ... }@Service("bankTransfer")
@Order(2)
public class BankTransferService implements PaymentService { ... } -
注入 Map：以 Bean 的名称（或通过 @Qualifier 指定的值）为 Key，以对应的 Bean 实例为 Value 注入。
@Service
public class PaymentRouter {
// Key 为 Bean 名称, Value 为对应实例
@Autowired
private Map<String, PaymentService> paymentServiceMap;public void payByMethod(String method) {
PaymentService service = paymentServiceMap.get(method); // 如 "alipay"
if (service != null) {
service.pay();
}
}
}
2. 使用 @Qualifier 进行精确选择
当需要指定某一个具体实现时，使用 @Qualifier 注解，其值通常与 @Component 派生注解（如 @Service）中指定的名称一致，或默认为类名的小写开头。
@Service
public class OrderService {
@Autowired
@Qualifier("wechatPay") // 明确指定注入名为 "wechatPay" 的 Bean
private PaymentService paymentService;
}
3. 使用 @Primary 设置默认实现
当有多个候选 Bean 且没有明确指定时，被标记为 @Primary 的实现会优先被注入。
@Service
@Primary // 当不指定 @Qualifier 时，默认注入此实现
public class DefaultPaymentService implements PaymentService { ... }
4. 编程式查找（更灵活，但更繁琐）
通过 ApplicationContext 或 ListableBeanFactory 在运行时动态获取。
@Component
public class DynamicServiceLocator {
@Autowired
private ApplicationContext applicationContext;
public List<PaymentService> getAllPaymentServices() {
// 获取所有实现该接口的 Bean 的 Map
Map<String, PaymentService> beansOfType =
applicationContext.getBeansOfType(PaymentService.class);
return new ArrayList<>(beansOfType.values());
}
public PaymentService getServiceByName(String name) {
return applicationContext.getBean(name, PaymentService.class);
}
}
⚙️ 二、核心原理解析
Spring 容器（主要是 DefaultListableBeanFactory）管理着所有 Bean 的定义（BeanDefinition）和实例。多实现注入的核心在于 依赖解析过程。
流程解析：
- 容器会查找所有类型为 PaymentService 或其子类型的 Bean 定义。
- 由于字段类型是 List<PaymentService>，Spring 的依赖解析器（DependencyDescriptor）会识别出这是一个集合类型的注入点。
- 此时，Spring 不会像注入单一 Bean 那样因找到多个候选而抛出 NoUniqueBeanDefinitionException，而是会触发特殊的“集合注入逻辑”。
- 容器实例化所有匹配的 PaymentService 实现类（遵循 Bean 的生命周期）。
- 将这些实例按照 @Order 定义的顺序（或无顺序）组装成一个 List。
- 最后将这个 List 注入到 ClientService 的对应字段中。
关键设计：
- @Primary 和 @Qualifier 的优先级：在单一 Bean 注入时，它们用于解决歧义。@Qualifier 的优先级高于 @Primary。
- @Order 的影响：它影响 List 中 Bean 的顺序，但不影响 Map 的 Key。
💡 三、实践建议与选择
| 需要遍历所有实现，执行统一操作（如插件、策略的批量初始化） | 注入 List/Set | 代码简洁，意图清晰，符合“对扩展开放”的原则。 |
| 需要根据运行时条件（如用户输入、配置）动态选择某一实现 | 注入 Map | 通过 Bean 名称作为 Key 进行路由，是 策略模式 的经典实现。 |
| 某一实现是绝大多数情况下的默认选择 | 使用 @Primary | 简化配置，避免在大量注入点重复使用 @Qualifier。 |
| 不同的依赖点需要固定不同的实现 | 使用 @Qualifier | 精准控制，意图明确。 |
| 需要在运行时动态发现和管理实现（如从数据库加载策略） | 编程式查找 | 灵活性最高，但需手动管理生命周期和依赖。 |
🚨 四、常见误区与避坑
总结而言，Spring 通过其强大的类型匹配和集合注入机制，为“一接口多实现”的场景提供了从自动收集 (List/Map) 到精确选择 (@Qualifier/@Primary) ，再到动态查找 (ApplicationContext) 的完整解决方案。理解其原理有助于在复杂业务场景中做出最合适的技术选型。
Vert.x 4 学习笔记-Vert.x中的方法原理与实现详解
