Spring如何配置让容器优先加载自定义Bean定义覆盖父项目配置

核心原因 #

spring.main.allow-bean-definition-overriding=true 的生效逻辑是后注册的同名Bean定义覆盖先注册的实例，你当前场景下自定义配置的加载时机早于父项目配置，父项目配置加载时反向覆盖了你的自定义Bean定义，最终生效的还是父项目的逻辑。

解决方案 #

按落地成本从低到高排序：

• 方案1：用@Primary标记自定义Bean，优先级最高
  不用纠结加载顺序，先把自定义配置类改名（不要和父项目配置类同名，避免类冲突），给你自己的beanA加@Primary注解，同时把BeanC注册到容器，Spring遇到多个同类型可注入Bean时，会优先选择带@Primary标记的实例：

  @Configuration
  public class CustomBizConfiguration {
      @Bean
      @Primary
      public BeanA beanA(BeanC beanC) {
          return new BeanA(beanC);
      }
  
      @Bean
      public BeanC beanC() {
          return new BeanC();
      }
  }
  

  这种方式不需要改动启动类配置，侵入性最低。

• 方案2：调整配置加载顺序，让自定义配置晚于父项目加载
  如果要完全替换父项目的Bean定义、不保留父项目的beanA实例，给自定义配置类加注解指定加载顺序，保证你的配置在父项目配置加载完成后再注册Bean，就能触发覆盖逻辑：

  @Configuration
  @AutoConfigureAfter(父项目Configuration类.class)
  public class CustomBizConfiguration {
      @Bean
      public BeanA beanA(BeanC beanC) {
          return new BeanA(beanC);
      }
  
      @Bean
      public BeanC beanC() {
          return new BeanC();
      }
  }
  

  如果父项目配置是Spring Boot自动配置类（注册在spring.factories或AutoConfiguration.imports中），直接给你的配置类加@Order(Ordered.LOWEST_PRECEDENCE)也能达到同样效果，Order值越大Bean注册时机越晚，越容易覆盖之前的定义。

• 方案3：直接排除父项目配置，从根源避免冲突
  如果父项目的这套配置你完全用不上，最干净的方式是直接在启动类上排除父项目的配置类，容器根本不会加载父项目的beanA定义，自然会使用你的自定义配置：

  @SpringBootApplication(exclude = {父项目的Configuration.class})
  public class Application {
      public static void main(String[] args) {
          SpringApplication.run(Application.class, args);
      }
  }
  

避坑提醒 #

• 自定义配置类不要和父项目的Configuration类用相同全限定名，否则会出现类加载冲突，换个独立类名即可。
• 自定义的BeanC必须手动注册到容器，否则注入时会报NoSuchBeanDefinitionException。
• 如果父项目的beanA方法上带@ConditionalOnMissingBean注解，不需要开Bean覆盖开关，只要你提前注册同名beanA，父项目的Bean就不会自动创建。

内容的提问来源于stack exchange，提问作者tobarata