文章要点
- 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
当你发现在 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 定义了事
Original: https://www.cnblogs.com/qnlcy/p/15012134.html
Author: 去哪里吃鱼
Title: Spring常见异常说明
原创文章受到原创版权保护。转载请注明出处：https://www.johngo689.com/577912/
转载文章受原作者版权保护。转载请注明原作者出处！