Spring中将存在继承关系的子类配置为Bean启动报多匹配Bean错误如何解决

Spring默认按类型进行依赖注入时，你的类继承结构会导致多个Bean匹配目标注入类型：

• 你注册了两个Bean：core.springtest.AMapper（类型为AMapper）、core.springtest.BMapper（类型为BMapper）
• 由于BMapper继承自AMapper，AMapper又继承自AbstractMapper，但凡有代码中注入AbstractMapper或AMapper类型的依赖且未指定具体Bean名称时，Spring会识别到两个符合类型要求的Bean，直接抛出expected single matching bean but found 2异常。

• 查看完整报错栈信息，定位触发注入异常的类、对应注入字段/构造参数，确认目标注入类型。
• 检查该注入点的注解配置，确认是否未指定要匹配的Bean名称。

根据业务场景选择任意一种即可：

1. 注入点加@Qualifier指定Bean名称
   明确指定当前注入点要匹配的Bean名称，示例：

@Autowired
@Qualifier("core.springtest.AMapper") // 填你要注入的Bean的name属性值
private AMapper mapper;

2. 给默认优先使用的Bean加@Primary
   如果某一个Bean是业务默认首选，在Bean定义处加@Primary注解，Spring遇到同类型多Bean时会优先选择该Bean：

@Bean(name = "core.springtest.AMapper")
@Primary
public AMapper getAMapper() {
  return new AMapper();
}

3. 改用@Resource注解按名称注入
   将@Autowired替换为@Resource注解，默认按字段名匹配Bean，也可手动指定name属性：

// 手动指定Bean名称更稳妥
@Resource(name = "core.springtest.BMapper")
private AMapper bMapper;

4. 移除不需要的Bean注册（仅适合业务不需要同时注册两个Bean的场景）
   如果业务上不需要同时把AMapper、BMapper都注册为Spring Bean，直接删掉对应@Bean定义即可。

内容的提问来源于stack exchange，提问作者abo