Spring常见异常说明

文章要点

Spring bean 的声明方式
Spring bean 的注入规则
Spring bean 的依赖查找规则
Spring bean 的名称定义方式和默认名称规则

XXX required a bean of type 'XXX' that could not be found.

这种情况，一般是因为没有在 Spring bean 容器中找到对应的 bean 。

bean 的声明

使用一个 bean，首先要声明一个 bean，使之交给 Spring 管理声明一个 bean , 常用有如下几种方式

xml 声明
注解声明

xml 声明

这种适用于非 SpringBoot 框架，老旧 Spring MVC 的框架使用形式。

现有架构常用于 dubbo bean 的声明，所有的 dubbo 引用和服务，都会声明成为一个 Spring bean

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

       http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 声明一个 Spring bean -->

    <bean id="testService" class="com.example.demo.TestService"/>

</beans>

当你发现在 Spring bean 容器中无法找到一个 dubbo 服务的时候（这时候是引用 dubbo 服务），请从如下角度去思考问题:

dubbo 服务的注册/引用了吗？
dubbo 服务的配置属性 interface 写的对吗？接口包打了吗？
dubbo 服务的引用配置属性 id 和使用 dubbo 服务的地方匹配吗？

上述问题都解决后，就不会出现找不到 dubbo bean 的问题了

注解声明

声明成 Spring bean 有一个基础的注解 @Component ，这些都用与类上。



@Component  //这个类实例 已经交给 Spring 管理了

public class ComponentService {

}

其余我们常用的 @Service 、@Repository 等均继承这个基础注解，都可以声明一个类的实例为 Spring bean

其继承关系如下

注解声明-高级版

高级版注解声明需要依赖 @Configuration 注解

上章节中的 ComponentService 也可以用如下的方式去声明



@Configuration

public class TestConfiguration {

    //声明 ComponentService

    @Bean

    public ComponentService componentService() {

        //返回一个自定义实例，交给 Spring bean 管理

        return new ComponentService();

    }

}

这种返回一个自定义 bean 的类型，常用于项目组件配置，如 DataSource 、JedisPool 等，业务系统一般用不到。

bean 的注入

我们可以使用 @Autowired （Spring）、 @Resource（JSR250规范）、@Inject(JSR330规范) 来进行注入

通常的，我们使用 @Autowired 足以满足各种注入场景，这里不再介绍另外两种。

在一个被 Spring 管理的类实例 （画重点） 当中引用另外一个 Spring bean 的方式，即 bean 的注入方式，有如下三种：

构造函数注入（官方推荐）
字段注入
方法注入

首先声明一个 bean，用于被别的 bean 注入

@Repository

public class TestRepository {

}

构造函数注入

@Service

public class TestService {

    private TestRepository testRepository;

    //@Autowired

    public TestService(TestRepository testRepository) {

        this.testRepository = testRepository;

    }

}

注意在构造函数上面，@Autowired 已经被我注释掉，原因如下：

As of Spring Framework 4.3,

an @Autowired annotation on such a constructor is no longer necessary

if the target bean defines only one constructor to begin with.

字段注入

@Service

public class TestService {

    @Autowired

    private TestRepository testRepository;

}

方法注入

@Service

public class TestService {

    private TestRepository testRepository;

    @Autowired

    public void setTestRepository(TestRepository testRepository) {

        this.testRepository = testRepository;

    }

}

以上方式可以混用，不拘泥于特定的形式。推荐构造函数注入而不是字段注入，是因为

字段注入完全依赖 Spring 的 IOC 功能，耦合性较高
防止不当使用时候，Spring bean 字段为空，这个是重点
当以也应该以 final 类型修饰字段时候，避免空指针的同时，也保证了依赖的不可变，不可变即安全
保证 Spring bean 的调用方调用的时候 bean 是完全初始化状态

至此，Spring bean 的注入已经初入门径了。

Field xxx in xxx.xxx.xxx.xx required a single bean, but 2 were found

@Autowired 是根据接口进行注入，上述问题是因为在 依赖查找 中发现同一 Interface 的多个实例 bean

场景还原如下

声明一个接口类

public interface MultiService {

}

添加两个实现类

@Service

public class MultiServiceImpl implements MultiService{

}

@Service

public class MMultiService implements MultiService{

}

注入 MultiService

@Service

public class TestService {

    //这里进行注入，然而 Spring 发现了2个实例，默认规则没有匹配上，不知道该注入哪个了

    @Autowired

    private MultiService multiService;

}

那么，在一个接口有多个实现 bean 的情况下，如何注入自己想要的 bean ?

依赖查找的部分规则

首先根据类型查找（byType），如果查找结果唯一，就返回给依赖赋值。
如果依赖不唯一，则根据名称查找（byName），bean 名称不会重复。

byName的匹配规则：

如果有 @Qualifier 指定依赖 bean 的名称，则拿指定名称与上述查找到的 bean 的名称进行匹配，匹配到则返回给依赖赋值
如果匹配不到，则拿 @Autowired 修饰的字段名或者方法参数名与上述查找到的 bean 的名称匹配，匹配到则返回给依赖赋值
匹配不到则报 Field xxx in xxx.xxx.xxx.xx required a single bean, but 2 were found 错误

bean 名称的指定

在声明一个 bean 的时候，可以指定 bean 名称

//这里指定了bean name 为 componentService

@Component("componentService")

public class ComponentService {

}

//这里指定了bean name 为 multiService

@Service("multiService")

public class MultiServiceImpl implements MultiService{

}

//这里指定了bean name 为 mMultiService

@Service("mMultiService")

public class MMultiService implements MultiService{

}

如果没有指定 bean 名称，默认会以当前类名的首字母小写为 bean 名称

但是如果当前类的第二个字母仍然为大写，那就会以当前类名为 bean 名称

如 MMultiService 的默认 bean 名称为 MMultiService

MultiServiceImpl 的默认 bean 名称为 multiServiceImpl

在使用一个 bean 的时候，也可以指定 bean 名称

@Service

public class TestService {

    @Autowired

    @Qualifier("MMultiService")  //指定 bean 名称

    private MultiService multiService;

}

org.springframework.context.annotation.ConflictingBeanDefinitionException: Annotation-specified bean name 'xxx' for bean class [xxx.xx.xx.xx] conflicts with existing, non-compatible bean definition of same name and class [xxx.xxx.xxx]

这种就是 bean 名称定义重复了，知道异常栈中提示的错误 bean 名称并修改即可

The bean 'xxx', defined in class path resource [xx/xx/xx.class], could not be registered. A bean with that name has already been defined in file [xx\xx\xx.class] and overriding is disabled.

这种是 bean 被声明了多次，检查是否配置类编写错误，一般业务 bean 不会声明多次

这里可能会提示你通过设置 spring.main.allow-bean-definition-overriding=true 允许 bean 定义被覆盖

Action:

Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true

请不要这么做！请找到 bean 声明冲突的地方，检查 bean 是否有特殊设置，根据业务进行取舍。不要简单覆盖 bean 定义了事