Spring5+自动注入泛型实现类列表报NoSuchBeanDefinitionException

问题相关代码与报错 #

基础代码定义 #

泛型接口：

public interface CustomGenerator<T,R> {
  void generate();
}

抽象基类：

// 原代码此处错误添加了@Service注解
public abstract class AbstractGenerator<T extends CustomClassA, R extends CustomClassB>
implements CustomGenerator<T,R> {}

两个具体实现类：

@Service
public class ConcreteC1 extends AbstractGenerator<CustomClassA, CustomClassB>{
 // 原代码此处方法未加public，未加@Override注解
 void generate(){
  // 业务逻辑
 }
}

@Service
public class ConcreteC2 extends AbstractGenerator<CustomClassA, CustomClassB>{
 // 原代码此处方法未加public，未加@Override注解
 void generate(){
  // 业务逻辑
 }
}

注入逻辑：

@Service
public class CustomService {
@Autowired
private List<CustomGenerator<CustomClassA, CustomClassB>> customGenerators;
// 原注释笔误，预期注入ConcreteC1、ConcreteC2两个实例
}

报错信息 #

org.springframework.beans.factory.UnsatisfiedDependencyException：字段customGenerators的依赖注入不满足，嵌套异常为org.springframework.beans.factory.NoSuchBeanDefinitionException：不存在符合条件的匹配类型Bean。

问题根因 #

• 抽象类AbstractGenerator上错误添加了@Service注解：抽象类无法被实例化，Spring扫描到该注解时会生成无效的Bean定义，干扰正常的泛型类型匹配逻辑。
• 具体实现类的接口方法实现不符合规范：CustomGenerator接口中generate()方法默认是public访问权限，两个实现类中该方法未显式声明public，也未添加@Override注解，降级为包级访问权限，没有真正实现接口方法，Spring无法识别这两个类为CustomGenerator的有效实现类。
• 多层泛型继承场景下，字段注入的泛型类型解析存在概率性匹配失败：Spring的泛型依赖注入在继承层级超过2层时，直接通过字段声明的泛型参数匹配可能无法正确识别所有符合条件的Bean。

解决步骤 #

第一步：修复基础代码错误 #

1. 删除AbstractGenerator类上的@Service注解，抽象类不需要被Spring实例化，仅作为基类使用即可。
2. 修正两个具体实现类的generate()方法，添加@Override注解并显式声明为public：

@Service
public class ConcreteC1 extends AbstractGenerator<CustomClassA, CustomClassB>{
 @Override
 public void generate(){
  // 业务逻辑
 }
}

@Service
public class ConcreteC2 extends AbstractGenerator<CustomClassA, CustomClassB>{
 @Override
 public void generate(){
  // 业务逻辑
 }
}

完成上述修改后，绝大多数场景下原有@Autowired注入List的代码就可以正常工作，两个实现类都会被自动注入到列表中。

第二步：如果仍存在泛型匹配失败，使用ResolvableType显式匹配 #

如果因为项目中其他泛型配置干扰导致仍无法正常注入，可以通过Spring内置的ResolvableType工具显式按泛型类型获取Bean，不需要逐个指定@Qualifier，后续新增同泛型参数的实现类会被自动纳入列表：

@Service
public class CustomService {
    private final List<CustomGenerator<CustomClassA, CustomClassB>> customGenerators;

    @Autowired
    public CustomService(ListableBeanFactory beanFactory) {
        // 明确指定要匹配的泛型类型：CustomGenerator<CustomClassA, CustomClassB>
        ResolvableType targetType = ResolvableType.forClassWithGenerics(
                CustomGenerator.class, 
                CustomClassA.class, 
                CustomClassB.class
        );
        this.customGenerators = new ArrayList<>(beanFactory.getBeansOfType(targetType).values());
    }

    // 业务中直接遍历customGenerators调用generate()即可
}

验证效果 #

启动项目后customGenerators列表会自动包含ConcreteC1、ConcreteC2两个实例，后续新增任意继承AbstractGenerator<CustomClassA, CustomClassB>的@Service实现类，都会被自动注入到该列表中，不需要修改现有注入逻辑。

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