Spring要求Bean的name全局唯一，不管是默认指定的bean name，还是手动声明的bean name，如果相同会导致项目无法启动
在Spring中，如果两个@Bean方法的方法名相同（即默认的Bean名称冲突），会导致Spring容器无法唯一标识Bean，从而抛出异常。以下是详细分析和解决方案：
问题重现
java
@Configuration public class ConfigA { @Bean public UserService userService() { // Bean名称: "userService" return new UserServiceImpl(); } } @Configuration public class ConfigB { @Bean public UserService userService() { // 冲突! 另一个"userService" return new AnotherUserServiceImpl(); } }启动时会抛出：ConflictingBeanDefinitionException: Annotation-specified bean name 'userService' for bean class [...] conflicts with existing [...]
原因分析
默认Bean名称唯一性
Spring要求Bean名称在容器中必须唯一。默认情况下，@Bean方法的名称直接作为Bean名称，因此同名方法会导致冲突。配置类的合并
如果多个@Configuration类被Spring组件扫描或显式导入（如通过@Import），它们声明的@Bean方法会被合并到同一个容器中，此时名称冲突会立即暴露。
解决方案
1.显式指定唯一名称
通过@Bean(name = "...")为每个Bean指定唯一名称：
java
@Configuration public class ConfigA { @Bean(name = "userServiceA") // 显式命名 public UserService userService() { return new UserServiceImpl(); } } @Configuration public class ConfigB { @Bean(name = "userServiceB") // 显式命名 public UserService userService() { return new AnotherUserServiceImpl(); } }2.使用@Qualifier区分
如果需要在注入时动态选择，可以结合@Qualifier：
java
@Bean(name = "serviceA") public UserService userService() { return new UserServiceImpl(); } @Bean(name = "serviceB") public UserService anotherUserService() { return new AnotherUserServiceImpl(); } // 注入时指定 @Autowired @Qualifier("serviceA") private UserService userService;3.使用@Primary标记优先Bean
如果两个Bean功能相似但需要默认选择一个：
java
@Bean @Primary // 标记为默认Bean public UserService primaryUserService() { return new DefaultUserServiceImpl(); } @Bean public UserService secondaryUserService() { return new AnotherUserServiceImpl(); }4.避免重复配置
检查是否意外重复定义了相同的Bean（例如，多个配置类扫描了相同的组件）。
其他注意事项
- 原型（Prototype）Bean：即使
scope = "prototype"，名称冲突依然会导致问题，需确保名称唯一。 - 测试环境：在测试中，如果使用
@ContextConfiguration加载多个配置类，同样需要避免Bean名称冲突。
总结
- 默认行为：
@Bean方法名即Bean名称，同名会导致冲突。 - 推荐做法：显式指定唯一名称（
@Bean(name = "...")）或使用@Qualifier。 - 设计建议：在大型项目中，为Bean命名时加入前缀（如
moduleAUserService）以避免全局冲突。
通过合理命名或使用Spring提供的注解，可以轻松解决Bean名称冲突问题。
