什么是NoSuchBeanDefinitionException，我该如何解决？

当

BeanFactory

询问a找不到其定义的bean实例时引发异常。这可能指向不存在的bean，不唯一的bean或没有关联的bean定义的手动注册的单例实例。

A

BeanFactory

基本上是代表Spring的

Control

容器反转的抽象。它在内部和外部向你的应用程序公开bean。当找不到或检索到这些bean时，将抛出

NoSuchBeanDefinitionException

。

以下是一个

BeanFactory（

或相关类）无法找到bean的简单原因，以及如何确保找到它的原因。

Bean不存在，尚未注册
在下面的示例中

@Configurationpublic class Example {    public static void main(String[] args) throws Exception {        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Example.class);        ctx.getBean(Foo.class);    }}class Foo {} 

我们还没有

Foo

通过

@Bean

方法，

@Component

扫描，XML定义或任何其他方式为该类型注册bean定义。在

BeanFactory

由管理

AnnotationConfigApplicationContext

因此没有哪里得到所要求的豆指示

getBean(Foo.class)

。上面的代码片段

Exception in thread "main" org.springframework.beans.factory.NoSuchBeanDefinitionException:    No qualifying bean of type [com.example.Foo] is defined

同样，尝试满足@Autowired依赖关系时可能引发了异常。例如，

@Configuration@ComponentScanpublic class Example {    public static void main(String[] args) throws Exception {        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Example.class);    }}@Componentclass Foo { @Autowired Bar bar; }class Bar { }

在这里，一个bean定义被注册Foo过@ComponentScan。但是Spring一无所知Bar。因此，在尝试自动装配bean实例的bar字段时，它找不到对应的Foobean。抛出（嵌套在中UnsatisfiedDependencyException）

Caused by: org.springframework.beans.factory.NoSuchBeanDefinitionException:     No qualifying bean of type [com.example.Bar] found for dependency [com.example.Bar]:         expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}

注册bean定义有多种方法。

• @Bean

  method in a

  @Configuration

  class or in XML configuration

• @Component

  (and its meta-annotations, eg.

  @Repository

  ) through

  @ComponentScan

  or

  <context:component-scan ... />

  in XML
• Manually through

  GenericApplicationContext#registerBeanDefinition

• Manually through

  BeanDefinitionRegistryPostProcessor

…和更多。

确保你期望的bean已正确注册。

一个常见的错误是多次注册bean，即。混合以上相同类型的选项。例如，我可能有

@Componentpublic class Foo {}

和一个XML配置

<context:component-scan base-packages="com.example" /><bean name="eg-different-name" "/>

而Java提供了

@importResource

注释。

Expected single matching bean, but found 2 (or more)

有时，你需要针对同一类型（或接口）的多个bean。例如，你的应用程序可能使用两个数据库，一个MySQL实例和一个Oracle实例。在这种情况下，你将需要两个DataSourcebean来管理与每个bean的连接。对于（简化的）示例，以下内容

@Configurationpublic class Example {    public static void main(String[] args) throws Exception {        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Example.class);        System.out.println(ctx.getBean(DataSource.class));    }    @Bean(name = "mysql")    public DataSource mysql() { return new MySQL(); }    @Bean(name = "oracle")    public DataSource oracle() { return new Oracle(); }}interface DataSource{}class MySQL implements DataSource {}class Oracle implements DataSource {}

抛出

Exception in thread "main" org.springframework.beans.factory.NoUniqueBeanDefinitionException:     No qualifying bean of type [com.example.DataSource] is defined:        expected single matching bean but found 2: oracle,mysql

因为通过@Bean方法注册的两个bean都满足的要求BeanFactory#getBean(Class)，即。他们都实行DataSource。在这个例子中，Spring没有机制来区分或区分两者。但是存在这样的机制。

你可以@Primary按照文档和本博文中的描述使用（及其等效的XML）。有了这个改变

@Bean(name = "mysql")@Primarypublic DataSource mysql() { return new MySQL(); } 

之前的代码片段不会引发异常，而是返回mysqlBean。

你还可以使用@Qualifier（及其在XML中的等效功能）对Bean选择过程进行更多控制，如文档所述。虽然@Autowired主要用于按类型自动接线，但@Qualifier可以按名称自动接线。例如，

@Bean(name = "mysql")@Qualifier(value = "main")public DataSource mysql() { return new MySQL(); }

现在可以注入为

@Qualifier("main") // or @Qualifier("mysql"), to use the bean nameprivate DataSource dataSource;

没有问题。@Resource也是一种选择。

使用错误的bean名称

就像有多种注册bean的方法一样，也有多种命名它们的方法。

@Bean

有

name

此bean的名称，或者如果是复数，则为该bean的别名。如果未指定，则Bean的名称为带注释的方法的名称。如果指定，方法名称将被忽略。

<bean>

有id表示属性一个bean唯一标识符和name 可用于创建在（XML）ID非法一个或多个别名。

@Component

及其元注释具有 value

该值可能表明建议使用逻辑组件名称，以在自动检测到组件的情况下将其转换为Spring bean。

如果未指定，则会为带注释的类型（通常是该类型名称的小驼峰版本）自动生成一个Bean名称。

@Qualifier

如前所述，你可以向Bean添加更多别名。

按名称自动布线时，请确保使用正确的名称。

更高级的案例
个人资料

Bean定义配置文件使你可以有条件地注册Bean。@Profile，具体来说，

指示一个或多个指定配置文件处于活动状态时，该组件有资格注册。

概要文件是一个命名的逻辑组，可以通过

ConfigurableEnvironment.setActiveProfiles(java.lang.String...)

将该spring.profiles.active属性设置为JVM系统属性，环境变量或Web应用程序的web.xml中的Servlet上下文参数来以编程方式激活或以声明方式激活 。概要文件也可以通过

@ActiveProfiles

注释在集成测试中以声明方式激活。

考虑以下示例，其中

spring.profiles.active

未设置属性。

@Configuration@ComponentScanpublic class Example {    public static void main(String[] args) throws Exception {        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Example.class);        System.out.println(Arrays.toString(ctx.getEnvironment().getActiveProfiles()));        System.out.println(ctx.getBean(Foo.class));    }}@Profile(value = "StackOverflow")@Componentclass Foo {}

这将不显示任何活动配置文件，并

NoSuchBeanDefinitionException

为

Fo

o Bean 抛出一个。由于

StackOverflow

概要文件未处于活动状态，因此未注册Bean。

相反，如果我

ApplicationContext

在注册适当的配置文件时初始化了

AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext();ctx.getEnvironment().setActiveProfiles("StackOverflow");ctx.register(Example.class);ctx.refresh();

Bean已注册，可以返回/注入。

AOP Proxies

Spring 大量使用AOP代理来实现高级行为。一些示例包括：

• Transaction management with

  @Transactional

• Caching with

  @Cacheable

• Scheduling and asynchronous execution with

  @Async

  and

  @Scheduled

为此，Spring有两个选择：

1. 使用JDK的Proxy类在运行时创建动态类的实例，该实例仅实现你的bean的接口并将所有方法调用委托给实际的bean实例。
2. 使用CGLIB代理在运行时创建一个动态类的实例，该实例同时实现目标bean的接口和具体类型，并将所有方法调用委托给实际的bean实例。
   以这个JDK代理示例为例（通过

   @EnableAsync

   的默认proxyTargetClass设置false）
   

@Configuration@EnableAsyncpublic class Example {    public static void main(String[] args) throws Exception {        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Example.class);        System.out.println(ctx.getBean(HttpClientImpl.class).getClass());    }}interface HttpClient {    void doGetAsync();}@Componentclass HttpClientImpl implements HttpClient {    @Async    public void doGetAsync() {        System.out.println(Thread.currentThread());    }}

在这里，Spring尝试找到HttpClientImpl我们希望找到的类型的bean，因为该类型明显地带有注释

@Component

。但是，相反，我们得到了一个例外

Exception in thread "main" org.springframework.beans.factory.NoSuchBeanDefinitionException:     No qualifying bean of type [com.example.HttpClientImpl] is defined

Spring包装

HttpClientImplBean

并通过Proxy仅实现的对象对其进行暴露

HttpClient

。所以你可以用

ctx.getBean(HttpClient.class) // returns a dynamic class: com.example.$Proxy33// or@Autowired private HttpClient httpClient;

始终建议对接口进行编程。如果不能，则可以告诉Spring使用CGLIB代理。例如，使用

@EnableAsync

，你可以设置proxyTargetClass为true。相似的注释（EnableTransactionManagement等）具有相似的属性。XML也将具有等效的配置选项。

ApplicationContext Hierarchies - Spring MVC

通过Spring，你可以A

pplicationContext

使用，以其他

ApplicationContext

实例作为父实例来构建实例

ConfigurableApplicationContext#setParent(ApplicationContext)

。子上下文可以在父上下文中访问bean，但事实并非如此。这篇文章详细介绍了什么时候有用，尤其是在Spring MVC中。

在典型的Spring MVC应用程序中，你定义了两个上下文：一个用于整个应用程序（根），另一个专门用于

DispatcherServlet

（路由，处理程序方法，控制器）。你可以在此处获得更多详细信息：

Spring framework中applicationContext.xml和spring-servlet.xml之间的区别

在此处的官方文档中也对此进行了很好的解释。

Spring MVC配置中的一个常见错误是在带有@EnableWebMvc注释

@Configuration

类或

<mvc:annotation-driven />XML

的根上下文中声明WebMVC配置，但

@Controller

在Servlet上下文中声明Bean。由于根上下文无法进入servlet上下文以查找任何bean，因此没有注册任何处理程序，并且所有请求均以404失败。你不会看到

NoSuchBeanDefinitionException

，但是效果是一样的。

确保你的bean在适当的上下文中注册，即。在那里他们可以通过用于WebMVC（注册豆中找到

HandlerMapping，HandlerAdapter，ViewResolver，ExceptionResolver

，等等）。最好的解决方案是正确隔离豆。该

DispatcherServlet

负责路由和处理请求，因此所有相关Bean应该进入它的上下文。

ContextLoaderListener

，它加载根上下文，应该初始化任何豆的应用需求的其余部分：服务，仓库等。

Arrays, collections, and maps

Spring会以特殊方式处理某些已知类型的Bean。例如，如果你尝试将的数组MovieCatalog注入字段

@Autowiredprivate MovieCatalog[] movieCatalogs;

Spring将找到所有类型的bean

MovieCatalog

，将它们包装在一个数组中，然后注入该数组。在Spring文档讨论中

@Autowired

对此进行了描述。类似的行为适用于Set，

List

和

Collection

注射的目标。

对于

Map

注入目标，如果键类型为，Spring也将以这种方式运行

String

。例如，如果你有

@Autowiredprivate Map<String, MovieCatalog> movies;

Spring将查找所有类型的bean，

MovieCatalog

并将它们作为值添加到

Map

，其中相应的键将是它们的bean名称。

如前所述，如果没有可用的请求类型的bean，Spring将抛出

NoSuchBeanDefinitionException

。但是，有时候，你只想声明这些集合类型的bean，例如

@Beanpublic List<Foo> fooList() {    return Arrays.asList(new Foo());}

并注入它们

@Autowiredprivate List<Foo> foos;

在此示例中，

Spring

将失败，

NoSuchBeanDefinitionException

因为Foo你的上下文中没有bean。但是你不想要

Foo

bean，你想要

List<Foo>

bean。在Spring 4.3之前，你必须使用

@Resource

对于本身定义为集合/映射或数组类型的bean，这

@Resource

是一个很好的解决方案，通过唯一名称引用特定的集合或数组bean。也就是说，从4.3版本开始，

@Autowired

只要元素类型信息保留在

@Bean

返回类型签名或集合继承层次结构中，就可以通过Spring的类型匹配算法来匹配集合/映射和数组类型 。在这种情况下，可以使用限定符值在同类型的集合中进行选择，如上一段所述。

这适用于构造函数，setter和字段注入。

@Resourceprivate List<Foo> foos;// or since 4.3public Example(@Autowired List<Foo> foos) {}

但是，对于

@Bean

方法，它将失败。

@Beanpublic Bar other(List<Foo> foos) {    new Bar(foos);}

在这里，Spring忽略任何方法

@Resource

或

@Autowired

注释方法，因为它是

@Bean

方法，因此无法应用文档中描述的行为。但是，你可以使用Spring

expression Language（SpEL）

来按其名称引用bean。在上面的示例中，你可以使用

@Beanpublic Bar other(@Value("#{fooList}") List<Foo> foos) {    new Bar(foos);}

引用命名的bean

fooList

并将其注入。