No qualifying bean of type问题解决

前言

No qualifying bean of type ‘xxx.xxx.xxx’ available: expected single matching bean but found 2:xxx.xxx.xxx

对于一个java开发新手来说， 应该经常会遇到这个问题，而且还不好意思询问周围同事，不要怕，今天就让我们解决掉它。

问题及解决方案

问题1

包扫描不正确或未扫描

• 默认情况下，如果使用了springboot,他会默认扫描启动类（使用了注解@SpringBootApplication）所在的包及子包，扫描的包中是否包含当前类所在的包。
• 检查 scanBasePackages扫描路径是否包含当前类所在的包。

解决方案

• 将当前类所在的包加入扫描路径即可，例如当前类所在包为 com.demo1

  @SpringBootApplication(@SpringBootApplication(scanBasePackages = {"com.demo","com.demo1"}))
  

  切记不要忘了扫描当前启动类所在的包 ，否则又会导致其他类不能注入。

问题2

当前类是否注入了spring环境

• 当前类是否有 @Service @Component等注解
• 当前类是否被@Bean初始化

解决方案

• 增加对应注解将类注入到spring环境即可，例如：

  @Service
  public class ServiceImpl1 implements Service{}
  或
  @Component
  public class ServiceImpl1 implements Service{}
  或
  @Bean
  public ServiceImpl serviceImpl(){
  	return new ServiceImpl();
  }
  

  使用@Bean方法所在的类也必须是要注入到spring环境中的。

问题3

多个类实现了同一个接口

• 查看当前接口是否被多个类实现

• 多个实现类是否未设置BeanName或者设置了相同的BeanName，例如：

  @Service
  public class ServiceImpl1 implements Service{}
  @Service
  public class ServiceImpl2 implements Service{}
  或
  @Service("Service1")
  public class ServiceImpl3 implements Service{}
  @Service("Service1")
  public class ServiceImpl4 implements Service{}
  

  以上方式都会出现异常。

• 注入Bean时是否指定了设置的BeanName，例如：

   @Autowired
   private Service service;
  

解决方案

当我们需要多个类实现同一个接口时，需要为每个实现类配置BeanName，例如：

@Service("serviceImpl3")
public class ServiceImpl3 implements Service{}
@Service("serviceImpl2")
public class ServiceImpl2 implements Service{}
@Service("serviceImpl1")
public class ServiceImpl1 implements Service{}

建议首字母小写。

以上没有问题，那么使用的时候还需要指定BeanName，例如：

@Qualifier(value = "serviceImpl1")
@Autowired
private Service service;

关于@Qualifier使用，详见：Spring @Qualifier 注释

如果不想在每个使用处设置@Qualifier，只想在特殊场景下设置，那么只需要在默认的实现类上增加注解@Primary,例如：

@Primary
@Service
public class ServiceImpl implements Service{}

那么在使用的时候就可以直接注入了，默认会使用ServiceImpl，例如：

@Autowired
private Service service;

注意事项

当存在多个相同类型的Bean，强烈建议使用@Primary把其中某一个Bean标识为“主要的”，使用@Autowired注入时会首先使用被标记为@Primary的Bean。