Spring基于泛型自动装配遇多Bean匹配报错，求排查方案

问题场景 #

我有一个Spring应用，处理Order（订单）和Fault（故障）两种对象，二者大部分处理逻辑相同，但数据来自不同数据库表。编写的代码如下：

MyService代码 #

@Service
public class MyService {
    private final Processor<Order> orderProcessor;
    private final Processor<Fault> faultProcessor;

    public MyService(Processor<Order> orderProcessor, Processor<Fault> faultProcessor) {
        this.orderProcessor = orderProcessor;
        this.faultProcessor = faultProcessor;
    }
    
    public void process(Map<String, List<BaseEntity>> input) {
        orderProcessor.process(input.get("ORDERS"));
        faultProcessor.process(input.get("FAULTS"));
    }
}

Processor实现 #

@Service
public class Processor<U extends BaseEntity> {

    private final BaseRepository<U> repository;

    public Processor(BaseRepository<U> repository) {
        this.repository = repository;
    }

    public void process(List<BaseEntity> entities) {
        // 查询仓库并执行处理逻辑
    }
}

仓库代码 #

@NoRepositoryBean
public interface BaseRepository<T extends BaseEntity> extends CrudRepository<T, Key> {
    @Transactional
    List<T> findAll(String id);
}

@Repository("order")
public interface OrderRepository extends BaseRepository<Order> {}

@Repository("fault")
public interface FaultRepository extends BaseRepository<Fault> {}

启动应用时失败，报错信息为："Constructor of Processor required a single bean but two were found"，使用的是Spring Boot 2.7.0 / Spring 5.3.2。

问题原因 #

• Java泛型类型擦除限制：运行时Java会擦除泛型信息，Spring容器无法通过Processor<Order>和Processor<Fault>的泛型参数区分Bean实例。当Processor被标注为@Service时，Spring尝试创建该Bean，但发现存在两个BaseRepository类型的候选Bean（OrderRepository和FaultRepository），无法确定注入哪一个，因此抛出冲突错误。
• Bean定义不明确：当前写法没有明确告诉Spring要为Order和Fault分别创建独立的Processor实例，Spring默认认为只需要一个Processor实例，而该实例的依赖存在多个候选，导致注入失败。

解决方案 #

方案1：手动配置Processor Bean #

移除Processor类上的@Service注解，通过配置类手动创建两个不同类型的ProcessorBean，并指定对应的仓库：

@Configuration
public class ProcessorConfig {

    @Bean
    public Processor<Order> orderProcessor(@Qualifier("order") BaseRepository<Order> orderRepository) {
        return new Processor<>(orderRepository);
    }

    @Bean
    public Processor<Fault> faultProcessor(@Qualifier("fault") BaseRepository<Fault> faultRepository) {
        return new Processor<>(faultRepository);
    }
}

修改后的Processor类：

public class Processor<U extends BaseEntity> {

    private final BaseRepository<U> repository;

    public Processor(BaseRepository<U> repository) {
        this.repository = repository;
    }

    public void process(List<BaseEntity> entities) {
        // 处理逻辑
    }
}

方案2：创建Processor子类并限定依赖 #

为每个业务类型创建Processor的子类，通过@Qualifier指定注入的仓库：

@Service
public class OrderProcessor extends Processor<Order> {
    public OrderProcessor(@Qualifier("order") BaseRepository<Order> repository) {
        super(repository);
    }
}

@Service
public class FaultProcessor extends Processor<Fault> {
    public FaultProcessor(@Qualifier("fault") BaseRepository<Fault> repository) {
        super(repository);
    }
}

修改MyService的注入逻辑：

@Service
public class MyService {
    private final OrderProcessor orderProcessor;
    private final FaultProcessor faultProcessor;

    public MyService(OrderProcessor orderProcessor, FaultProcessor faultProcessor) {
        this.orderProcessor = orderProcessor;
        this.faultProcessor = faultProcessor;
    }
    
    public void process(Map<String, List<BaseEntity>> input) {
        orderProcessor.process(input.get("ORDERS"));
        faultProcessor.process(input.get("FAULTS"));
    }
}

方案3：利用Spring泛型Bean匹配（辅助优化） #

Spring 4+支持根据泛型参数自动匹配Bean，但需要结合@Qualifier明确依赖。不过这种方式更适合配合方案1或2使用，确保每个Processor实例的依赖唯一。

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