NoUniqueBeanDefinitionException: expected single matching bean but found 2

文章目录


前言

看到这个错误,大致也能猜出错误的原因,就是spring中注入的bean重复了,本来应该是单利的bean,但是现在却找到了两个,那么导致这个问题的原因是什么?如何解决呢?


一、错误现象

运行项目或者运行junit测试,直接报错,抛出错误的位置:

错误控制台日志:


二、原因分析

其实产生这种错误的原因有以下三种:

  • 1 手欠

例如: 你有 A B 两个service ,都要注入,但是你注入的时候,手欠的加入了注入的名字, A B 都注入为了 a,就会抛出如上错误;

  • 2 同一个类被多次扫描,且扫描结果不一致

例如: 我今天遇到的这个错误就是,两次扫描,两次扫描key不一致,一次是类,一次是类全路径名,但是都放入了spring中,抛出如上错误;

复制代码
@Nullable
	public Object resolveNotUnique(ResolvableType type, Map<String, Object> matchingBeans) throws BeansException {
		throw new NoUniqueBeanDefinitionException(type, matchingBeans.keySet());
	}

正常来说这段代码, matchingBeans.keySet() 的长度应该为1 ,但是我找到了两个;

  • 3 虽然不是手欠,但是仍然是第一个错误

有两个名为A 的bean,但是包不同, com.ceshi.A 和 com.ce.shi.A,但是注入的时候,都为 a;


三、解决办法

其实第一种和第三种,都比较解决;

第一种: 别手欠

第三种: 起不同名字,或者注入不同的名字
第二种:

其实这种是由于编码不规范,或者任意增加包扫描导致的错误,造成了两次扫描;例如 com.ceshi.A

第一次扫描: SpringBootApplication 默认就会扫描包下所有要注入的bean,此时扫描到的bean名称,在不自定义的情况下,就为 a;

第一次扫描: 自己自定义了一个扫描类,且开启了一个东西
nameGenerator = FullyQualifiedAnnotationBeanNameGenerator.class

它会导致你扫描的所有bean都变为了全路径bean名称,就为 com.ceshi.A

至此,发现了此问题的原因,那么解决办法就是,在原有的启动类上,也加入这个开启全路径名称bean 的注入;


总结

那么为什么他会自定义了一个包扫描,且开启了nameGenerator = FullyQualifiedAnnotationBeanNameGenerator.class呢?

其实不怪他:

因为这个项目要引入很多自定的jar包,jar包中就是有与目前同名的bean要注入,但是包路径不同,为了都可以注入成功,所以最终也只能采用此办法,相当于全局都开启了这个 配置;

这个问题,百度了半个多小时也没有解决,虽然这篇文字写的不多,但是我相信一定可以派上大用场,貌似目前还没有解决这个问题的办法,以及原因分析;
字少事儿大原则~~

相关推荐
wuminyu4 小时前
专家视角看Java字节码加载与存储指令机制
java·linux·c语言·jvm·c++
callJJ5 小时前
Spring Data Redis 两种编程模型详解:同步 vs 响应式
java·spring boot·redis·python·spring
phltxy6 小时前
Spring Cloud 分布式服务部署实战:从 0 到 1 实现微服务上线
spring·spring cloud·微服务
wbs_scy6 小时前
Linux线程同步与互斥(三):线程同步深度解析之POSIX 信号量与环形队列生产者消费者模型,从原理到源码彻底吃透
java·开发语言
jinanwuhuaguo7 小时前
(第三十三篇)五月的文明奠基:OpenClaw 2026.5.2版本的文明级解读
android·java·开发语言·人工智能·github·拓扑学·openclaw
xmjd msup8 小时前
spring security 超详细使用教程(接入springboot、前后端分离)
java·spring boot·spring
952368 小时前
SpringBoot统一功能处理
java·spring boot·后端
Lyyaoo.8 小时前
优惠券秒杀业务分析
java·开发语言
消失的旧时光-19438 小时前
统一并发模型:线程、Reactor、协程本质是一件事(从线程到协程 · 第6篇·终章)
java·python·算法
勿忘初心12218 小时前
Java 国密 SM4 加密工具类实战(Hutool + BouncyCastle)|企业级数据加密 + 兼容 JDK8
java·数据安全·数据加密·后端开发·企业级开发·国密 sm4