关于@Configuration使用@Order实现Bean覆盖的配置顺序问题

问题本质 #

你遇到的是Spring处理嵌套@Configuration静态类时，@Order注解无法控制配置类的加载顺序，实际顺序由类名/方法名的字母排序决定，导致Bean覆盖逻辑无法按预期执行，该问题在Spring 5.2.24.RELEASE、5.3.28、6.0.10版本中均存在。

原因解析 #

Spring的@Order注解核心作用是控制Bean实例的执行顺序（如AOP切面、CommandLineRunner）或@ComponentScan扫描时的组件注册顺序，但对于嵌套在@Configuration类中的静态配置类，Spring的配置解析逻辑默认通过反射获取嵌套类，然后按类名自然排序处理，完全忽略@Order配置——这并非Bug，而是嵌套配置类的设计逻辑，官方从未承诺@Order会作用于此类场景。

可行解决方案 #

1. 拆分嵌套类为独立配置类+@Order #

将嵌套静态配置类抽成独立的@Configuration类，在类上标注@Order，确保Spring能扫描到这些类。这种场景下Spring会严格遵循@Order指定的顺序加载配置类，保证Bean覆盖逻辑生效。

2. 用@Import显式控制加载顺序 #

在外部配置类上通过@Import注解，按需求顺序导入嵌套静态配置类，Spring会严格按照@Import中的顺序加载配置，彻底绕过反射排序的影响：

@Configuration
@Import({TargetOverrideConfig.class, BaseConfig.class}) 
// 先加载TargetOverrideConfig，再加载BaseConfig，后者Bean会覆盖前者
public class OuterConfig {

    @Configuration
    static class BaseConfig {
        @Bean
        public MyBean myBean() {
            return new MyBean("base");
        }
    }

    @Configuration
    static class TargetOverrideConfig {
        @Bean
        public MyBean myBean() {
            return new MyBean("override");
        }
    }
}

3. 用@Primary/@Qualifier强制Bean优先级 #

如果必须保留嵌套结构，可在需要优先注入的Bean方法上添加@Primary，强制Spring优先选择该Bean；或通过@Qualifier指定Bean名称，在注入时明确选择目标实例，避免依赖加载顺序：

@Configuration
public class OuterConfig {

    @Configuration
    static class BaseConfig {
        @Bean("baseBean")
        public MyBean myBean() {
            return new MyBean("base");
        }
    }

    @Configuration
    static class OverrideConfig {
        @Primary
        @Bean("overrideBean")
        public MyBean myBean() {
            return new MyBean("override");
        }
    }
}

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