外观
04 - Spring 如何完成依赖注入
适用版本:Spring Framework 6.x。示例优先采用构造器注入。
前置阅读:03 - getBean() 背后的单例 Bean 创建链路。本文聚焦
populateBean()前后的候选发现与选择。
摘要
依赖注入是指:对象声明自己需要哪些协作对象,由容器找到这些对象并传入。例如,订单服务声明需要支付服务,Spring 就负责选择支付实现,而订单服务不必自行创建它。构造器参数、字段和需要注入的方法参数都是注入点;满足注入要求、可供选择的 Bean 则称为候选。
理解这套机制,先看三个问题:注入点需要什么、哪些候选满足要求、最终如何取得并传入对象。依赖不存在、候选过多、泛型不匹配或限定符错误,都可能使创建失败。本文先用两个支付实现说明选择问题,再沿源码入口解释解析过程。
1. 场景:两个实现类,Spring 应该选谁
以下 Java 代码均为局部片段,需要 Spring Framework 6.x 的 spring-context 依赖、相应导入和组件注册配置。同名类展示的是替代写法,不应同时声明。这里假设组件扫描已注册两个支付实现和订单服务,且没有额外的候选选择配置。@Service 用于将类标记为服务组件。
java
interface PaymentService { }
@Service
class AlipayService implements PaymentService { }
@Service
class WechatPayService implements PaymentService { }java
@Service
class OrderService {
OrderService(PaymentService paymentService) { }
}OrderService 的构造器只要求一个 PaymentService,两个实现却都满足这个类型。Spring 无法从接口类型推断订单应该使用哪种支付渠道,因此通常会因 NoUniqueBeanDefinitionException(候选不唯一异常)而创建失败;外层异常可能再包装为依赖无法满足或 Bean 创建失败。
2. 注入处理链
注入时机取决于注入点的位置。构造器参数必须在调用构造器前准备好,因此在 createBeanInstance() 的实例化阶段解析;字段和方法注入则在对象已创建后的 populateBean() 属性填充阶段处理。两者都需要解析依赖,但不能把构造器注入归入属性填充。
AutowiredAnnotationBeanPostProcessor 是参与实例创建和属性填充的 Bean 后处理器。它帮助发现候选构造器,并处理字段、方法上的 @Autowired 等注入信息。通常的单构造器组件不必额外标注 @Autowired;多个构造器的选择则需要结合注解和参数可解析性判断。
沿源码阅读时,可先按职责区分入口:
AutowiredAnnotationBeanPostProcessor#determineCandidateConstructors:参与发现候选构造器,后续由创建流程解析构造参数并实例化;AutowiredAnnotationBeanPostProcessor#postProcessProperties:在属性填充阶段处理注解声明的字段和方法注入;DefaultListableBeanFactory#resolveDependency:根据注入要求解析依赖。
真正解析依赖时,注入点会用 DependencyDescriptor(依赖描述对象)表达。它把分散在声明上的要求汇总起来,包括:
- 所需类型;
- 泛型信息;
- 注解与限定符;
- 是否必须;
- 字段或方法参数信息。
其中,泛型信息如 Handler<Order> 中的 Order,限定符则是进一步缩小候选范围的条件,例如 @Qualifier("wechatPayService")。必需性决定依赖缺失时能否继续创建对象。下面展示普通、必需的单值依赖解析模型,省略特殊形态和版本相关的优化分支。
图表将在阅读到此处时加载…
发现候选与选择结果是两个步骤:前者排除不满足约束的对象,后者在满足约束的对象中确定结果。数组、集合等依赖还可能需要多个结果,因此下列步骤是职责概览,不是所有分支都严格遵循的调用顺序:
- 先处理数组、集合、Map、Optional、Provider 等特殊依赖形态;
- 从容器及必要的父容器中找出类型兼容的候选;
- 应用
autowire-candidate(是否允许参与自动注入)、泛型和@Qualifier约束; - 对单值依赖,在剩余候选中结合
@Primary、优先级、默认候选和依赖名称等规则选择; - 必需依赖仍无法得到唯一结果时抛出异常。
候选名称确定后,容器还要获取对应 Bean;如果依赖尚未创建,这一步可能继续触发它的创建流程。因此,候选唯一也不保证注入成功,依赖自身的构造或初始化仍可能失败。
精确选择规则会随 Spring 小版本演进。参数名匹配、快速匹配和 fallback(后备候选)等行为需要区分 Spring 6.1 与 6.2,不能将这些分支视为整个 6.x 的统一规则。依赖构造参数名匹配时,必须保留参数名编译信息,并在目标版本测试;业务选择更适合显式使用限定符。
2.1 并非所有可注入对象都有普通 BeanDefinition
BeanDefinition 是描述 Bean 如何创建的定义,不是 Bean 实例。普通业务候选通常来自容器中注册的定义,但 ApplicationContext(应用上下文)、BeanFactory(负责获取和创建 Bean 的容器接口)等基础设施依赖,还可以通过 resolvable dependency 机制提供:容器直接登记某类依赖对应的对象或获取方式。
因此,“能注入”不等于“能在普通业务 Bean 定义列表里找到”。排查时还要区分内建依赖,以及由 Scope(决定实例共享范围的作用域)或 Provider(按需获取对象的接口)动态解析的对象。
3. 正确消除候选歧义
使用 @Primary
java
@Primary
@Service
class AlipayService implements PaymentService { }@Primary 表达“多个候选都满足要求时,优先使用这个默认实现”。在本节场景中,它让单值 PaymentService 注入选择 AlipayService。它适合系统存在默认实现的情况,不能替代按订单渠道动态选择支付服务的业务逻辑。
使用 @Qualifier
java
@Service
class OrderService {
private final PaymentService paymentService;
OrderService(@Qualifier("wechatPayService") PaymentService paymentService) {
this.paymentService = paymentService;
}
}@Qualifier 在注入点上增加筛选条件。这里假设组件按默认规则命名,WechatPayService 对应 Bean 名称 wechatPayService,因此限定条件可选中它。限定符应写在实际解析依赖的位置:构造器注入要写在参数上。
当调用方需要明确区分业务语义时,可以采用这种写法;大型系统也可创建自定义限定注解,减少字符串散落。@Primary 负责表达默认偏好,@Qualifier 负责缩小候选范围,两者承担不同职责。
4. 为什么推荐构造器注入
字段注入示例:
java
@Service
class OrderService {
@Autowired
private PaymentService paymentService;
}字段注入发生在构造器执行之后。仅调用构造器得到的对象还没有这个依赖,测试需要额外完成字段赋值,通常要借助容器或反射;这里也无法用 final 字段表达构造时必须提供的依赖。
构造器注入示例:
java
@Service
class OrderService {
private final PaymentService paymentService;
OrderService(PaymentService paymentService) {
this.paymentService = paymentService;
}
}构造器签名直接列出必需依赖,测试可以传入替代实现;final 则表达该引用在构造后不再重新赋值。这样更容易建立对象的不变量,也就是对象正常使用时必须一直满足的基本条件。这里保证的是依赖引用在构造时传入,不意味着后续初始化回调已经执行完毕。
构造器注入也更容易暴露循环依赖:若 A 的构造器需要 B,而 B 的构造器又需要 A,双方都无法先完成实例化。相互依赖的原因应从职责设计上检查,具体缓存边界见阅读导航中的第 7 篇。
5. 集合与泛型注入
单值注入要回答“选哪一个”,集合注入则回答“有哪些满足要求的候选”。例如下面的 List<PaymentService> 可以接收符合注入条件的支付实现,需要导入 java.util.List:
java
@Service
class PaymentRouter {
private final List<PaymentService> services;
PaymentRouter(List<PaymentService> services) {
this.services = services;
}
}@Order 注解或 Ordered 接口可以表达排序信息,影响列表中候选的顺序。排序解决的是先后次序,不会替调用方判断应使用哪个渠道,也不要把未声明的集合顺序当作业务规则。
泛型也可参与候选筛选。例如,下面的接口用类型参数 T 表达处理的数据类型:
java
interface Handler<T> { void handle(T value); }假设业务已定义 Order 类型并注册相应处理器,注入 Handler<Order> 时,Spring 可利用可解析的泛型信息筛选候选。关键在于容器能否从类型声明中取得这些信息:原始类型是省略类型参数的写法,如 Handler;类型擦除是 Java 运行时不完整保留泛型类型参数的机制。原始类型、复杂代理和类型擦除可能影响判断,应在目标版本用测试验证。
集合注入的结果是“所有符合条件的候选”,不是业务路由表。若业务按渠道码选择实现,应显式建立 Map<Channel, PaymentService> 或注册表,并验证重复业务键,而不是依赖 Bean 名称和 @Order 暗含业务含义。
6. 可选与延迟依赖
可选依赖改变的是“缺失时能否继续”,延迟依赖改变的是“何时获取对象”,两者解决的问题不同。以下构造器片段需要 java.util.Optional 导入,并由业务提供 AuditService 类型:
java
OrderService(Optional<AuditService> auditService) { }Optional<AuditService> 表达审计服务可以缺失,调用方必须处理没有值的情况。它不会替多个候选作业务选择。若审计是业务必需项,不应为了让应用启动而将它改成 Optional。
需要延迟或按需获取时,可以使用 ObjectProvider<T>。它先提供获取依赖的入口,让业务在需要时再请求对象。下面的片段需要导入 org.springframework.beans.factory.ObjectProvider、提供带 run() 方法的 Exporter 类型,并将 ReportService 注册到容器:
java
class ReportService {
private final ObjectProvider<Exporter> exporters;
ReportService(ObjectProvider<Exporter> exporters) {
this.exporters = exporters;
}
void export() {
exporters.orderedStream().forEach(Exporter::run);
}
}调用 export() 时,orderedStream() 按排序规则提供符合条件的 Exporter,随后逐个执行 run()。按需获取可能推迟候选解析或创建失败的暴露时机,因此业务仍需考虑调用时的失败处理。
7. 容易踩的坑
- 依赖参数名兜底匹配可能受编译参数和版本行为影响,不应替代明确的
@Qualifier。 - 把集合排序当作支付路由:顺序不能替代按业务键选择实现。
- 对字段或方法使用
@Autowired(required = false):依赖缺失时可能跳过注入,调用方必须处理未赋值状态;不要用它隐藏必需依赖缺失。 - 注入
Map<String, Service>时,键通常是 Bean 名称,不一定是业务类型码。 - 直接
new对象不会自动触发 Spring 注入;构造器注入的对象也可以手工创建,但调用方需要自行传入依赖。
8. 排障清单
- 普通业务候选的 BeanDefinition 是否存在,组件扫描或注册配置是否生效?
- 注入点需要的准确类型和泛型是什么?
- 有几个候选,分别为什么被保留或排除?
@Qualifier是否写在真正的注入点上?- 注入对象是否由 Spring 创建?
- 若候选经过 AOP(面向切面编程)代理,即由代理转发调用以加入额外行为,代理暴露的类型是否满足注入类型?
- 依赖是否属于集合、Optional、Provider 或容器内建依赖等特殊形态?
- 测试编译是否保留参数名,线上构建参数是否一致?
9. 总结
依赖注入的核心,是根据注入点的要求筛选候选,再取得相应对象并传入。 单值依赖需要确定一个结果,集合依赖可以接收多个候选,可选和延迟依赖则有各自的解析边界。
DependencyDescriptor保存类型、泛型、限定符和必需性等信息。- 构造器注入能更清楚地表达对象的不变量和依赖边界。
- 候选冲突应通过业务明确的限定规则解决,不要依赖偶然的名称匹配。
阅读导航
- Bean 创建入口:03 - getBean() 背后的单例 Bean 创建链路
- 注入完成后的回调:05 - Bean 生命周期与扩展点顺序
- 注入处理器为何能介入:06 - BeanPostProcessor
- 延迟与可选依赖:08 - FactoryBean、BeanFactory 与 ObjectProvider
- 构造器环为何失败:07 - 三级缓存与循环依赖