Spring依赖注入意外匹配正确Bean的原因排查

问题场景 #

接口与类定义 #

interface BankService {}

interface TransferService {}
 
class BankTransferServiceImpl implements BankService, TransferService {}

class BankingClient {
  public BankingClient(BankService bs) {}
}

普通Java代码编译失败 #

public static void main(String[] args) {
  TransferService ts = new BankTransferServiceImpl();
  BankingClient bs = new BankingClient(ts); // 编译报错：类型不匹配
}

Spring配置却能成功注入 #

@Configuration
public class MyConfig {

  @Bean
  TransferService transferService() {
    return new BankTransferServiceImpl();
  }

  @Bean
  BankingClient bankingService(BankService bs) {
    return new BankingClient(bs);
  }
}

明明只注册了TransferService类型的Bean，却能注入到需要BankService的BankingClient中，原因是什么？

原因解析 #

• Spring依赖注入基于实际运行时类型匹配：@Bean方法的返回类型只是Spring注册Bean时的一个"标识类型"，但容器实际存储的是方法返回的实例对象。这里transferService()返回的实例是BankTransferServiceImpl，它同时实现了BankService和TransferService两个接口。
• 静态编译检查vs动态类型识别：普通Java代码是静态类型检查，编译器只看变量的声明类型（TransferService），不会识别它的实际运行时类型，所以直接传参会触发类型不匹配错误。而Spring在注入时会检查Bean实例的实际类型，扫描它所有实现的接口和继承的父类，判断是否符合依赖的类型要求。
• Spring的类型匹配逻辑：当bankingService方法需要BankService类型的依赖时，Spring会遍历容器中所有Bean，检查它们的实际类型是否兼容BankService（即是否实现了该接口或继承了相关父类）。这里那个注册为TransferService的Bean，实际实例是BankTransferServiceImpl，完全符合BankService的类型要求，因此可以成功注入。

内容的提问来源于stack exchange，提问作者energize-cactus