如何解决Could not autowire错误：存在多个UserBusService类型Bean

核心问题 #

Spring容器中同时存在两个UserBusService类型的Bean：

• userBusService（来自UserBusService.java）
• userBusServiceImpl（来自UserBusServiceImpl.java）

@Autowired默认按类型注入，当同一类型有多个Bean时，Spring无法自动确定要注入哪一个，就会抛出这个错误。

为什么参考项目没问题？大概率是这几个差异： #

• 你在UserBusService接口上误加了Spring组件注解（比如@Service、@Component），而参考项目里的接口只是普通接口，没有任何Spring注解，只有实现类UserBusServiceImpl加了@Service/@Component这类注解。
• 你的项目包扫描范围过大，导致接口类被Spring当成Bean注册了，而参考项目的包扫描只覆盖实现类所在路径。
• 你通过其他方式（比如XML配置、配置类）重复注册了UserBusService类型的Bean，参考项目没有这种情况。

排查步骤 #

1. 打开UserBusService.java，检查是否有@Service、@Component、@Repository这类注解，有就直接删掉——接口不需要被Spring注册成Bean，只有实现类需要。
2. 对比参考项目的UserBusService和UserBusServiceImpl文件，逐行看注解差异，这是最快定位问题的方法。
3. 查看Spring的Debug日志：开启org.springframework包的Debug级别日志，能看到每个Bean的注册来源，确认两个UserBusService类型Bean是怎么被注册进来的。

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