spring

品牌型号：联想拯救者R7000

系统：Windows 10专业版

软件版本：Spring Boot 4.0.2

我们在做Spring Boot项目开发时，可能会遇到【The bean 'xxx', defined in class, could not be registered.】这样的报错信息，这个错误就是典型的Bean名称冲突问题。当项目规模逐渐扩大，特别是引入了很多第三方依赖时，就非常有可能会遇到Bean重名的问题，每个程序员都需要知道Bean重名冲突的解决办法。本文将为大家介绍Spring bean重名了怎么办，Spring Boot多个Bean冲突怎么解决的相关内容。

一、Spring Bean重名了怎么办

Spring容器中的Bean名称需要唯一，如果Bean重名，尤其是多模块开发的场景下，会导致启动错误，为了避免Bean重名的问题，在开发阶段就需要避免重复命名，下面我会为大家介绍一些容易出现Bean重名的场景。

1、多个@Configuration配置类中的@Bean方法同名

这是比较常见的Bean冲突场景，例如多模块开发场景中，模块A的ConfigA和模块B的ConfigB都定义了一个名为name的@Bean方法时，Spring容器在启动时就会抛出Bean名称冲突异常。例如下图代码中，BeanNameConfigA和BeanNameConfigB都定义了返回String类型的name()方法，此时Spring无法判断应该使用哪个Bean，启动时就会报错误，报错信息如下。

2、@Component组件扫描与@Bean手动注册同名Bean

在引入第三方starter或者进行框架整合时特别容易出现这类Bean重复，例如项目中使用了自己的UserService组件类，同时又通过@Bean方式手动注册了一个同名的UserService Bean，此时就会出现名称冲突。Spring容器既扫描到了@Component注解的UserService，又在@Configuration中通过@Bean方式注册了同名的Bean，这种双重注册就会导致启动失败。

3、同一配置类中存在多个返回类型相同但方法名不同的@Bean

虽然这种情况不会直接报重名错误，但在注入时如果不使用@Qualifier指定具体的Bean名称，Spring会提示，需要单例Bean但实际找到了多个。

二、Spring Boot多个Bean冲突怎么解决

上文为大家介绍了Spring bean重复的情况，在开发阶段要避免出现Bean冲突的问题，假设已经出现了多个Bean冲突，应该怎么解决呢？下面我就为大家介绍一下针对上文介绍的多种Bean冲突的解决方案。

1、添加allow-bean-definition-overriding: true配置

在application.yml添加【allow-bean-definition-overriding: true】配置后，@Bean手动注册的userService会覆盖@Component扫描的userService，所以userServiceFromConfig和userServiceFromComponent实际上拿到的是同一个Bean实例，都是UserServiceConfig.userService()创建的，就解决了重复Bean的问题。

2、使用@Qualifier指定要注入的Bean

在进行依赖注入时，通过@Qualifier注解指定需要注入的Bean名称，这是比较精确的控制方式，例如上文介绍的同一配置类中存在多个返回类型相同但方法名不同的@Bean，都可以通过该注解指定Bean的名称。

3、使用@Bean注解的name属性指定自定义Bean名称

例如下图所示，在BeanNameConfigA中，将name()方法的注解修改为@Bean("alice")，另外的同名Bean指定为其他名称，这样两个Bean就是不同的名称，可以正常注册。

三、总结

以上就是Spring Bean重名了怎么办，Spring Boot多个Bean冲突怎么解决的相关内容。在开发时，要注意Bean重名的问题，可能会出现编译错误或者启动错误，如果遇到了Bean冲突的问题，可以参考上文方案解决，希望对你有所帮助。