深入Spring Boot：怎样排查expected single matching bean but found 2的异常

最新推荐文章于 2025-03-05 16:13:40 发布
最新推荐文章于 2025-03-05 16:13:40 发布
阅读量8.1w 收藏 47
点赞数 11
分类专栏： Java spring spring-boot 深入Spring Boot 文章标签： spring spring-boot java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hengyunabc/article/details/78762121
版权

写在前面

这个demo来说明怎么排查一个常见的spring expected single matching bean but found 2的异常。

https://github.com/hengyunabc/spring-boot-inside/tree/master/demo-expected-single

调试排查 expected single matching bean but found 2 的错误

把工程导入IDE里，直接启动应用，抛出来的异常信息是：

Caused by: org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of type 'javax.sql.DataSource' available: expected single matching bean but found 2: h2DataSource1,h2DataSource2
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveNamedBean(DefaultListableBeanFactory.java:1041) ~[spring-beans-4.3.9.RELEASE.jar:4.3.9.RELEASE]
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.getBean(DefaultListableBeanFactory.java:345) ~[spring-beans-4.3.9.RELEASE.jar:4.3.9.RELEASE]
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.getBean(DefaultListableBeanFactory.java:340) ~[spring-beans-4.3.9.RELEASE.jar:4.3.9.RELEASE]
	at org.springframework.context.support.AbstractApplicationContext.getBean(AbstractApplicationContext.java:1090) ~[spring-context-4.3.9.RELEASE.jar:4.3.9.RELEASE]
	at org.springframework.boot.autoconfigure.jdbc.DataSourceInitializer.init(DataSourceInitializer.java:71) ~[spring-boot-autoconfigure-1.4.7.RELEASE.jar:1.4.7.RELEASE]
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.0_112]
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:1.8.0_112]
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_112]
	at java.lang.reflect.Method.invoke(Method.java:498) ~[na:1.8.0_112]
	at org.springframework.beans.factory.annotation.InitDestroyAnnotationBeanPostProcessor$LifecycleElement.invoke(InitDestroyAnnotationBeanPostProcessor.java:366) ~[spring-beans-4.3.9.RELEASE.jar:4.3.9.RELEASE]
	at org.springframework.beans.factory.annotation.InitDestroyAnnotationBeanPostProcessor$LifecycleMetadata.invokeInitMethods(InitDestroyAnnotationBeanPostProcessor.java:311) ~[spring-beans-4.3.9.RELEASE.jar:4.3.9.RELEASE]
	at org.springframework.beans.factory.annotation.InitDestroyAnnotationBeanPostProcessor.postProcessBeforeInitialization(InitDestroyAnnotationBeanPostProcessor.java:134) ~[spring-beans-4.3.9.RELEASE.jar:4.3.9.RELEASE]
	... 30 common frames omitted

很多人碰到这种错误时，就乱配置一通，找不到下手的办法。其实耐心排查下，是很简单的。

抛出异常的原因

异常信息写得很清楚了，在spring context里需要注入/获取到一个DataSource bean，但是现在spring context里出现了两个，它们的名字是：h2DataSource1,h2DataSource2

那么有两个问题：

  1. 应用是在哪里要注入/获取到一个DataSource bean？
  2. h2DataSource1,h2DataSource2 是在哪里定义的？

使用 Java Exception Breakpoint

在IDE里，新建一个断点，类型是Java Exception Breakpoint（如果不清楚怎么添加，可以搜索对应IDE的使用文档），异常类是上面抛出来的NoUniqueBeanDefinitionException。

当断点停住时，查看栈，可以很清楚地找到是在DataSourceInitializer.init() line: 71这里要获取DataSource：

Thread [main] (Suspended (exception NoUniqueBeanDefinitionException))
	owns: ConcurrentHashMap<K,V>  (id=49)
	owns: Object  (id=50)
	DefaultListableBeanFactory.resolveNamedBean(Class<T>, Object...) line: 1041
	DefaultListableBeanFactory.getBean(Class<T>, Object...) line: 345
	DefaultListableBeanFactory.getBean(Class<T>) line: 340
	AnnotationConfigEmbeddedWebApplicationContext(AbstractApplicationContext).getBean(Class<T>) line: 1090
	DataSourceInitializer.init() line: 71
	NativeMethodAccessorImpl.invoke0(Method, Object, Object[]) line: not available [native method]
	NativeMethodAccessorImpl.invoke(Object, Object[]) line: 62
	DelegatingMethodAccessorImpl.invoke(Object, Object[]) line: 43
	Method.invoke(Object, Object...) line: 498
	InitDestroyAnnotationBeanPostProcessor$LifecycleElement.invoke(Object) line: 366
	InitDestroyAnnotationBeanPostProcessor$LifecycleMetadata.invokeInitMethods(Object, String) line: 311
	CommonAnnotationBeanPostProcessor(InitDestroyAnnotationBeanPostProcessor).postProcessBeforeInitialization(Object, String) line: 134
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).applyBeanPostProcessorsBeforeInitialization(Object, String) line: 409
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).initializeBean(String, Object, RootBeanDefinition) line: 1620
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).doCreateBean(String, RootBeanDefinition, Object[]) line: 555
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).createBean(String, RootBeanDefinition, Object[]) line: 483
	AbstractBeanFactory$1.getObject() line: 306
	DefaultListableBeanFactory(DefaultSingletonBeanRegistry).getSingleton(String, ObjectFactory<?>) line: 230
	DefaultListableBeanFactory(AbstractBeanFactory).doGetBean(String, Class<T>, Object[], boolean) line: 302
	DefaultListableBeanFactory(AbstractBeanFactory).getBean(String, Class<T>, Object...) line: 220
	DefaultListableBeanFactory.resolveNamedBean(Class<T>, Object...) line: 1018
	DefaultListableBeanFactory.getBean(Class<T>, Object...) line: 345
	DefaultListableBeanFactory.getBean(Class<T>) line: 340
	DataSourceInitializerPostProcessor.postProcessAfterInitialization(Object, String) line: 62
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).applyBeanPostProcessorsAfterInitialization(Object, String) line: 423
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).initializeBean(String, Object, RootBeanDefinition) line: 1633
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).doCreateBean(String, RootBeanDefinition, Object[]) line: 555
	DefaultListableBeanFactory(AbstractAutowireCapableBeanFactory).createBean(String, RootBeanDefinition, Object[]) line: 483
	AbstractBeanFactory$1.getObject() line: 306
	DefaultListableBeanFactory(DefaultSingletonBeanRegistry).getSingleton(String, ObjectFactory<?>) line: 230
	DefaultListableBeanFactory(AbstractBeanFactory).doGetBean(String, Class<T>, Object[], boolean) line: 302
	DefaultListableBeanFactory(AbstractBeanFactory).getBean(String) line: 197
	DefaultListableBeanFactory.preInstantiateSingletons() line: 761
	AnnotationConfigEmbeddedWebApplicationContext(AbstractApplicationContext).finishBeanFactoryInitialization(ConfigurableListableBeanFactory) line: 867
	AnnotationConfigEmbeddedWebApplicationContext(AbstractApplicationContext).refresh() line: 543
	AnnotationConfigEmbeddedWebApplicationContext(EmbeddedWebApplicationContext).refresh() line: 122
	SpringApplication.refresh(ApplicationContext) line: 762
	SpringApplication.refreshContext(ConfigurableApplicationContext) line: 372
	SpringApplication.run(String...) line: 316
	SpringApplication.run(Object[], String[]) line: 1187
	SpringApplication.run(Object, String...) line: 1176
	DemoExpectedSingleApplication.main(String[]) line: 17

定位哪里要注入/使用DataSource

要获取DataSource具体的代码是：

//org.springframework.boot.autoconfigure.jdbc.DataSourceInitializer.init()
	@PostConstruct
	public void init() {
		if (!this.properties.isInitialize()) {
			logger.debug("Initialization disabled (not running DDL scripts)");
			return;
		}
		if (this.applicationContext.getBeanNamesForType(DataSource.class, false,
				false).length > 0) {
			this.dataSource = this.applicationContext.getBean(DataSource.class);
		}
		if (this.dataSource == null) {
			logger.debug("No DataSource found so not initializing");
			return;
		}
		runSchemaScripts();
	}

this.applicationContext.getBean(DataSource.class); 要求spring context里只有一个DataSource的bean，但是应用里有两个，所以抛出了NoUniqueBeanDefinitionException。

从BeanDefinition获取bean具体定义的代码

我们再来看 h2DataSource1,h2DataSource2 是在哪里定义的？

上面进程断在了DefaultListableBeanFactory.resolveNamedBean(Class<T>, Object...) 函数里的 throw new NoUniqueBeanDefinitionException(requiredType, candidates.keySet()); 这一行。

那么我们在这里执行一下（如果不清楚，先搜索下IDE怎么在断点情况下执行代码）：

this.getBeanDefinition("h2DataSource1")

返回的信息是：

Root bean: class [null]; scope=; abstract=false; lazyInit=false; autowireMode=3; dependencyCheck=0; autowireCandidate=true; primary=false; factoryBeanName=demoExpectedSingleApplication; factoryMethodName=h2DataSource1; initMethodName=null; destroyMethodName=(inferred);
defined in com.example.demo.expected.single.DemoExpectedSingleApplication

可以很清楚地定位到h2DataSource1这个bean是在 com.example.demo.expected.single.DemoExpectedSingleApplication里定义的。

所以上面两个问题的答案是：

  1. 是spring boot代码里的DataSourceInitializer.init() line: 71这里要获取DataSource，并且只允许有一个DataSource实例
  2. h2DataSource1,h2DataSource2 是在com.example.demo.expected.single.DemoExpectedSingleApplication里定义的

解决问题

上面排查到的原因是：应用定义了两个DataSource实例，但是spring boot却要求只有一个。那么有两种办法来解决：

  1. 使用@Primary来指定一个优先使用的DataSource，这样子spring boot里自动初始的代码会获取到@Primary的bean
  2. 把spring boot自动初始化DataSource相关的代码禁止掉，应用自己来控制所有的DataSource相关的bean

禁止的办法有两种：

  1. 在main函数上配置exclude

        @SpringBootApplication(exclude = { DataSourceAutoConfiguration.class, DataSourceTransactionManagerAutoConfiguration.class })

  2. 在application.properties里配置：

        spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,org.springframework.boot.autoconfigure.jdbc.DataSourceTransactionManagerAutoConfiguration

总结

  • 排查spring初始化问题时，灵活使用Java Exception Breakpoint
  • 从异常栈上，可以很容易找到哪里要注入/使用bean
  • 从BeanDefinition可以找到bean是在哪里定义的（哪个Configuration类/xml）

公众号

欢迎关注公众号：横云断岭的专栏，专注分享Java，Spring Boot，Arthas，Dubbo。

横云断岭的专栏

available: expected single matching bean but found 2问题笔记
qq_43422599的博客
07-17 852
available: expected single matching bean but found 2问题笔记aop，mybatis
SpringBoot启动报： expected single matching bean but found 2
人真正变得强大，不是因为守护着自尊心，而是抛开自尊心的时候。
11-13 2613
异常截图： 从异常信息中大致可以看到：我们本来想让他找GmsChannelService，结果启动时发现找到两个，一个为GmsChannelService，一个为GmsChannelServiceImpl： 再来看下controller层： 我们在这里使用了@Autowired注解，想通过自动装箱的方式获取该service 再来看下serviceImpl层： 解决方案： controller层：加@Qualifier serviceImp层 @Service -->@Service(GmsCh
记mybatisplus使用的一次坑：required a single bean, but 2 were found
最新发布
qq_37978057的博客
03-05 438
至于为什么不行，到底是配置没生效还是其他原因，暂时先放下。但是此时还有一个疑问，最开始加的配置到底有没有生效？问题解决，启动成功！
spring注解报错：expected single matching bean but found 2
洗刷先生的博客
03-11 2990
一定要指定到mapper。
expected single matching bean but found 2
夜的瞳
12-06 2万+
SSM开发，使用springMVC框架中自带的spring验证框架来验证数据，编写了一个org.springframework.validation.Validator接口的验证器类SignUpValidator来对领域数据进行验证时，报了以下错误： “org.springframework.beans.factory.BeanCreationException: Error creating b...
【报错解决】expected single matching bean but found 2
热门推荐
我梦
10-11 3万+
【报错】Error creating bean with name '***ManagementController': Unsatisfied dependency expressed through field '***Service'; nested exception is org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of type 'com.***. ***.servic
【学习之路】spring boot 整合redis 报错
i_csdn2050的博客
04-27 1485
目录一. 踩坑原因二. 踩坑之前二. 解决方法PS 一. 踩坑原因 报错内容： 2022-04-27 17:34:24.004 WARN 2159230 --- [ main] ConfigServletWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.facto
Spring6新特性之：既生@Primary，何生@Fallback
1点25的博客
07-20 370
换句话说，如果Spring根据类型找到了多个Bean，会选择其中加了@Primary的Bean来进行注入，因此，同类型的多个Bean中只能有一个加了@Primary，如果有多个也会报错。因为orderService1加了@Fallback注解，相当于备胎，只有当没有其他Bean可用时，才会用orderService1这个备胎，有其他Bean就会优先用其他Bean。如果根据类型只找到一个Bean就用不着他两了，另外，同类型多个Bean中@Primary的Bean只能有一个，但可以有多个@Fallback。
No qualifying bean of type问题解决
m0_67402914的博客
06-07 1323
对于一个java开发新手来说， 应该经常会遇到这个问题，而且还不好意思询问周围同事，不要怕，今天就让我们解决掉它。将当前类所在的包加入扫描路径即可，例如当前类所在包为 问题2 当前类是否注入了spring环境 当前类是否有 @Service @Component等注解 当前类是否被@Bean初始化 解决方案 增加对应注解将类注入到spring环境即可，例如： 问题3 多个类实现了同一个接口 查看当前接口是否被多个类实现多个实现类是否未设置BeanName或者设置了相同的BeanNa
swagger2.2.2报错：relProviderPluginRegistry,linkDiscovererRegistry,entityLinksPluginRegistry
liinux-Talk is cheap,show me the code.
12-14 1384
最近遇到一个swagger2.2.2版本的问题，启动SpringBoot2.2.2报如下错： *************************** APPLICATION FAILED TO START *************************** Description: Parameter 0 of method linkDiscoverers in org.springf...
开发：异常收集之 expected single matching bean but found 2
Thancks
08-27 1万+
今天写完两个service实现，启动项目发现了这个错 expected single matching bean but found 2: [oldFrSplittinglogServiceImpl, frSplittinglogServiceImpl] 后来发现，
mybatis-plus的service注入报错问题：expected single matching bean but found 2
小小白的博客
12-13 8202
一、问题代码结构 1、service接口 public interface IUserService extends IService<User> {} 2、service接口实现类 @Service public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements IUserService {} 3、entity类 public class User { @Tabl
NoUniqueBeanDefinitionException: expected single matching bean but found 2
学海无涯,我用JAVA
09-08 3779
看到这个错误,大致也能猜出错误的原因,就是spring中注入的bean重复了,本来应该是单利的bean,但是现在却找到了两个,那么导致这个问题的原因是什么?如何解决呢?那么为什么他会自定义了一个包扫描,且开启了呢?其实不怪他:因为这个项目要引入很多自定的jar包,jar包中就是有与目前同名的bean要注入,但是包路径不同,为了都可以注入成功,所以最终也只能采用此办法,相当于全局都开启了这个 配置;
expected single matching bean but found 2: xxx, yyy
Counter-Strike大牛
10-22 462
比如使用@Autowired引入，则可以使用@Qualifier(“xxx”)进行指定，或者直接将@Autowired替换为@Resource(“xxx”)。另一个方法是在创建Bean的地方加Primary，比如如果是@Bean方式生成，则可以加@Primary注解；第一个方案比较灵活，但有些情况不适用，比如@Autowired地方太多，改起来很耗时，或者引入的地方都是jar包class文件，无法改动，这时候就只能用第二种方案了。字面意思理解，期望得到一个类，但是发现了两个：xxx，yyy。
available: expected single matching bean but found 2
YKorey的博客
08-19 8446
available: expected single matching bean but found 2: smsLogServiceImpl,ISmsLogService 如上图，是在启动的时候出现的问题，从字意上可以看出，是说在注入bean的时候，出现了两个，spring不知道应该用哪个为好，这里说下可能出现到的原因： 1、譬如service层和mapper层没有引入对应的注解（@Service/@Mapper）引起的。 2、一个接口被两个实现类实现了，当使用到@Autowired注解引入的时候.
available: expected single matching bean but found 2: student,studentdev
09-28
"available: expected single matching bean but found 2: student,studentdev"是一个异常，它表示在期望只有一个匹配的bean的情况下找到了两个bean。这个异常通常发生在使用Spring Framework进行依赖注入的过程中。这种情况通常发生在有多个具有相同类型的bean的情况下，而Spring无法确定要注入哪个bean。 解决这个问题的方法有几种。一种方法是通过为bean添加限定符或名称来唯一标识它们，以便Spring可以正确地选择要注入的bean。另一种方法是使用@Primary注解来标记一个首选的bean，以确保它被选择注入。
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值