跳到主要内容
约 7 分钟3 张卡

依赖注入

依赖注入(Dependency Injection,DI)是由外部提供一个对象需要的协作对象。在 Spring 中,这项工作由容器完成,例如把仓库与支付客户端交给订单服务。选择注入方式时,要判断依赖何时必须可用;同一接口有多个实现时,还要说明容器该选哪一个。这两点决定了对象能否正常创建,也影响测试时能否方便地替换依赖。

1. 面试核心​

先记住这几条,再读正文
  • 必需依赖优先使用构造器注入,让对象构造完成时就取得依赖,测试也能直接传入替代实现。卡 · 构造器注入
  • Spring 4.3 起,只有一个构造器的 Bean 可以省略 @Autowired;字段注入则要等实例创建后再填充依赖。
  • @Autowired 从类型兼容的候选中选择,@Qualifier 缩小范围,@Primary 为单值注入指定首选项。卡 · 多个候选 Bean
  • ObjectProvider.getIfAvailable() 允许没有候选,但不能忽略多个候选无法唯一选择的歧义。卡 · ObjectProvider
  • @Resource 优先按名称解析,省略名称且默认名称不存在时,才可回退到按类型解析。

2. 构造器注入​

构造器注入是通过构造器参数提供依赖。对象缺少哪个依赖就无法工作,可以把它写成构造器参数,让创建者在构造时就提供:

@Service
public class OrderService {
private final OrderRepository repository;
private final PaymentClient paymentClient;

public OrderService(
OrderRepository repository,
PaymentClient paymentClient) {
this.repository = repository;
this.paymentClient = paymentClient;
}
}

OrderService 构造完成时,已经拿到 repository 和 paymentClient。两个字段都是 final,之后不能重新指向其他对象。测试时也可以直接调用这个构造器,传入提供固定行为的替代实现,无需先启动 Spring 容器。

Spring 4.3 起,单构造器 Bean 可省略 @Autowired。存在多个构造器时,应明确指定注入入口。参数过多说明需要检查类的职责和依赖边界,改成字段注入只会隐藏这些依赖。

构造器要求依赖先存在,因此直接依赖环会在创建阶段暴露,具体见 Spring 循环依赖。

3. Setter 注入​

Setter 注入是在对象创建后,通过属性方法设置依赖,适合可选或需要重新配置的依赖。可选依赖缺失时,对象仍要能正常工作,例如默认跳过审计输出:

private AuditSink auditSink = AuditSink.noop();

@Autowired(required = false)
public void setAuditSink(AuditSink auditSink) {
this.auditSink = auditSink;
}

缺少 AuditSink 候选时,容器跳过这个 Setter,保留 AuditSink.noop() 默认实现。有候选时,再调用 Setter 替换它。若缺少依赖就无法工作,应改为构造器参数,避免把空值错误推迟到业务调用时。

Setter 允许构造后替换依赖,因此对象还要面对依赖变化后的行为。只有确实需要重新配置时,才应保留这种可变性。

4. 字段注入​

字段注入是让容器在实例创建后直接填充成员变量。声明虽然短,但调用方无法从构造器签名看出这些依赖:

@Autowired
private PaymentClient paymentClient;

字段由容器在实例化后填充,因此直接 new 得到的对象还缺少支付客户端。测试需要启动容器、额外装配或借助反射,字段也难以通过正常构造赋值为 final。

框架基础设施和遗留代码中仍会见到字段注入。新业务代码使用构造器,可以让必需依赖直接出现在签名中,也更容易独立测试。

5. 多个候选 Bean​

同一个接口有多个 Bean 时,只有确定唯一候选,容器才能完成单值注入。@Autowired 先按类型寻找候选,也会利用泛型信息区分类型。@Qualifier 用来缩小范围,@Primary 则在匹配候选中指定首选。例如,下面的构造器明确要求线上支付客户端:

OrderService(@Qualifier("online") PaymentClient client) {
this.client = client;
}

online 可以是限定符,也可匹配候选 Bean 名,但匹配范围始终是类型兼容的候选。限定符宜表达稳定的业务角色,例如线上支付,也可定义 @OnlinePayment 这样的业务注解。这样,更换实现类名称时,注入意图仍然清楚。

缺少更强的选择标记时,容器还可用字段名或参数名匹配 Bean 名。Spring 6.1 起,参数名回退需要启用 -parameters 编译选项,让编译产物保留参数名。若最终仍有多个候选无法唯一选择,注入就会报错。

业务需要多个实现共同参与时,可以注入 List<PaymentClient> 收集匹配候选。集合仍包含其他匹配项,@Primary 只为单值注入指定首选。列表顺序可通过 @Order 调整,注入 Map<String, PaymentClient> 时则以 Bean 名为键。

按请求动态选择支付策略时,可以把这张 Map 交给明确的路由器。路由器需要校验传入的键,并定义找不到策略时的回退或报错行为。

6. ObjectProvider​

ObjectProvider<T> 是向容器按需获取 T 类型对象的接口。注入 Provider 时,拿到的是获取入口;调用它的方法时,才解析目标 Bean。这适合推迟创建,或在每次使用时重新向容器获取对象。不同方法对候选缺失和歧义的处理如下:

API缺失候选多候选且无法唯一选择
getObject()抛异常抛异常
getIfAvailable()返回 null抛异常
getIfUnique()返回 null返回 null
orderedStream()空流按顺序遍历候选

Optional<T> 也允许没有候选,但仍要求单值解析唯一。required=false 只放宽缺失条件,多个候选造成的歧义仍需用限定符等规则解决。

Provider 把获取时机写进了代码。如果大量使用它只是为了避开循环依赖,结构问题就会延迟到运行时暴露,职责拆分仍需完成。

7. 不同作用域的注入​

作用域决定一个 Bean 在哪些调用之间共享。singleton 在同一个容器内为同一份 Bean 定义共享一个实例,prototype 则在每次向容器获取时新建。singleton 直接注入 prototype,只会取得创建时的那一份,后续方法调用不会重新获取它。

每次都需要新实例时,可以用 Provider、方法注入或作用域代理,将目标获取推迟到使用时。request Bean 在同一请求中共享,通过作用域代理获取它时,必须存在有效的请求上下文。

按需获取的示例和异步线程限制见 Spring 循环依赖。

8. Resource 名称解析​

注入目标由稳定名称标识时,可以使用 @Resource。它来自通用注解规范,适用于字段和 Setter,优先按名称获取 Bean。Spring 6 使用 jakarta.annotation.Resource:

@Resource(name = "onlinePayment")
private PaymentClient paymentClient;

示例显式指定 onlinePayment,容器需要找到这个名称且类型兼容的 Bean。省略 name 时,默认名称取字段名或 Setter 对应的属性名。只有这个默认名称不存在时,Spring 才可回退到按类型解析。

@Autowired 属于 Spring 注解,以类型候选为起点,并支持构造器。团队应统一注入约定,使用明确的名称或限定符表达选择意图,减少对字段名偶然匹配的依赖。

9. 常见问题​

9.1 只有一个实现类,也需要通过接口注入吗?​

不一定,要看接口是否表达了独立的协作约定,例如支付服务需要提供哪些能力。即使只有一个实现,只要边界清晰、确有替换需求,按接口注入仍有价值。若接口只是逐项复制实现类方法,却没有独立含义,就会增加维护成本。

9.2 把依赖声明为可选,就可以不处理缺失情况了吗?​

10. 面试题卡片​

11. 参考资料​

来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明