如何控制@PropertySource注解在自动配置类中的应用顺序？

首先明确：@AutoConfigureBefore/After无法控制@PropertySource的属性源顺序，因为这些注解仅控制自动配置类的Bean实例化和@Bean方法执行顺序，而@PropertySource的属性源加载是在配置类被解析为BeanDefinition的阶段（由PropertySourceRegistryPostProcessor处理），这个阶段的顺序和自动配置的注解逻辑无关。

针对你的问题，以下是几种可行的解决方案：

1. 通过EnvironmentAware手动调整属性源位置（最精准可靠） #

直接在加载@PropertySource的配置类中实现EnvironmentAware接口，在拿到环境实例后主动调整属性源的位置，完全可控：

@Configuration
@PropertySource(value = "classpath:my-custom.properties")
public class CustomPropertyConfig implements EnvironmentAware {

    @Override
    public void setEnvironment(Environment environment) {
        if (environment instanceof ConfigurableEnvironment configurableEnv) {
            MutablePropertySources propertySources = configurableEnv.getPropertySources();
            // 获取我们添加的属性源（名称默认是"classpath:my-custom.properties"）
            PropertySource<?> customSource = propertySources.get("classpath:my-custom.properties");
            
            if (customSource != null) {
                // 先移除，再插入到指定位置
                propertySources.remove("classpath:my-custom.properties");
                // 示例：插入到系统环境变量之后，默认application.properties之前
                propertySources.addBefore("applicationConfig: [classpath:/application.properties]", customSource);
            }
        }
    }
}

你可以根据需求调整addBefore/addAfter的目标属性源名称，常用的内置属性源名称包括：

• systemEnvironment：系统环境变量
• systemProperties：JVM系统属性
• applicationConfig: [classpath:/application.properties]：默认的应用配置文件

2. 自定义PropertySourceFactory指定添加位置 #

通过自定义PropertySourceFactory，在创建属性源时直接指定添加到环境的特定位置，替代默认的addLast：

public class PriorityPropertySourceFactory extends DefaultPropertySourceFactory {

    @Override
    public PropertySource<?> createPropertySource(String name, EncodedResource resource) throws IOException {
        PropertySource<?> propertySource = super.createPropertySource(name, resource);
        ConfigurableEnvironment environment = (ConfigurableEnvironment) SpringApplication.getBootstrapContext().get(Environment.class);
        MutablePropertySources sources = environment.getPropertySources();
        
        // 示例：直接添加到最前面（优先级最高）
        sources.addFirst(propertySource);
        // 或者添加到指定位置
        // sources.addBefore("systemEnvironment", propertySource);
        
        return propertySource;
    }
}

然后在@PropertySource中指定该Factory：

@AutoConfiguration
@PropertySource(value = "classpath:my-custom.properties", factory = PriorityPropertySourceFactory.class)
public class MyAutoConfig {
    // 自动配置内容
}

3. 用@Order控制普通配置类的处理顺序 #

如果使用普通@Configuration类而非自动配置类，可以通过@Order注解控制配置类的解析顺序，进而影响@PropertySource的属性源添加顺序：

// 优先级更高（值越小优先级越高），会先被处理，属性源先被addLast（在列表中位置更靠前，优先级更高）
@Configuration
@Order(1)
@PropertySource("classpath:high-priority.properties")
public class HighPriorityConfig {}

// 优先级更低，后被处理，属性源后被addLast（在列表中位置更靠后，优先级更低）
@Configuration
@Order(2)
@PropertySource("classpath:low-priority.properties")
public class LowPriorityConfig {}

注意：这种方式仅能控制初始添加顺序，若有其他自动配置类的属性源干预，可能无法保证最终顺序，不如第一种方式精准。

补充：关于Spring属性源的顺序逻辑 #

Spring的MutablePropertySources采用前置优先的规则：列表前面的属性源会被优先读取，同名属性会被前面的覆盖。默认情况下，@PropertySource会调用addLast将属性源添加到列表尾部，所以先加载的属性源会在列表更靠前的位置，优先级更高；如果后续有其他属性源被addFirst或插入到前面，就会覆盖之前的属性。

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