Spring Ant构建项目@Autowired注入报No qualifying bean found异常咨询

核心异常表现 #

项目启动时抛出UnsatisfiedDependencyException嵌套NoSuchBeanDefinitionException，错误提示为：找不到匹配依赖类型org.springframework.batch.item.ItemProcessor<com.abc.proj.model.FileHeader,com.abc.proj.model.FileHeader>的合格Bean，尽管已经给字段加了@Autowired和@Qualifier("headerProcessor")注解。

问题根因 #

核心问题是泛型类型不匹配，Spring从4.0版本开始支持泛型依赖注入，会严格校验注入字段的泛型参数类型：

• DelegateProcessor中待注入的headerProcessor字段声明类型为ItemProcessor<FileHeader, FileHeader>
• 实际被@Component标注的HeaderProcessor实现类，声明实现的接口是ItemProcessor<Object, Object>
• 即使指定了@Qualifier匹配Bean名称，Spring在候选Bean类型校验阶段就会把泛型不匹配的HeaderProcessor排除，最终判定没有合格的可注入Bean。

修复方案 #

修改HeaderProcessor类的接口泛型声明，和注入字段的泛型类型保持完全一致：

@Component
public class HeaderProcessor implements ItemProcessor<FileHeader, FileHeader>{
    @Autowired
    private HeaderValidatorDao headerValidatorDao;

    // 原有业务处理逻辑
}

补充排查项（修改泛型后仍报错时检查） #

• 确认HeaderProcessor所在包已经被Spring组件扫描路径覆盖，没有出现类漏扫的情况
• 确认Ant构建脚本配置正确，HeaderProcessor类已经被编译并输出到运行类路径下，没有构建遗漏类文件的问题
• 后续注入detailProcessor、trailerProcessor时，也要保证对应实现类的泛型声明和字段泛型完全匹配，避免触发同类报错

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