核心思路 #

要让库中的defaults-(profile).yml作为低优先级默认值，允许业务项目通过自身配置覆盖，关键是利用Spring Boot的EnvironmentPostProcessor扩展点，在Spring加载业务项目配置之前注入库的默认属性源，确保业务配置的优先级更高。

步骤1：实现EnvironmentPostProcessor #

编写自定义环境后置处理器，负责加载库中的默认属性文件，并将其添加到环境属性源的合适位置：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.env.EnvironmentPostProcessor;
import org.springframework.boot.env.YamlPropertySourceLoader;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.PropertySource;
import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import java.io.IOException;
import java.util.List;

public class DefaultPropertiesEnvironmentPostProcessor implements EnvironmentPostProcessor {

    private static final String DEFAULT_FILE_PREFIX = "defaults-";
    private static final String YML_SUFFIX = ".yml";

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        // 处理激活的Profile，无激活Profile时使用default
        List<String> activeProfiles = List.of(environment.getActiveProfiles());
        if (activeProfiles.isEmpty()) {
            activeProfiles = List.of("default");
        }

        YamlPropertySourceLoader loader = new YamlPropertySourceLoader();
        // 加载对应Profile的默认配置
        for (String profile : activeProfiles) {
            loadAndAddPropertySource(loader, DEFAULT_FILE_PREFIX + profile + YML_SUFFIX, environment);
        }
        // 加载通用默认配置（无Profile）
        loadAndAddPropertySource(loader, "defaults.yml", environment);
    }

    private void loadAndAddPropertySource(YamlPropertySourceLoader loader, String fileName, ConfigurableEnvironment environment) {
        Resource resource = new ClassPathResource(fileName);
        if (!resource.exists()) {
            return;
        }
        try {
            List<PropertySource<?>> propertySources = loader.load(fileName, resource);
            // 将库的默认属性源添加到业务项目配置之前，确保业务配置可覆盖
            String appConfigName = "applicationConfig: [classpath:/application.yml]";
            for (PropertySource<?> source : propertySources) {
                if (environment.getPropertySources().contains(appConfigName)) {
                    environment.getPropertySources().addBefore(appConfigName, source);
                } else {
                    environment.getPropertySources().addFirst(source);
                }
            }
        } catch (IOException e) {
            throw new RuntimeException("Failed to load default properties file: " + fileName, e);
        }
    }
}

步骤2：注册后置处理器 #

在库的src/main/resources/META-INF/spring.factories文件中添加以下配置，让Spring Boot自动识别并加载该处理器：

org.springframework.boot.env.EnvironmentPostProcessor=com.your.package.DefaultPropertiesEnvironmentPostProcessor

注意替换com.your.package为实际的类包路径。

步骤3：放置默认属性文件 #

在库的src/main/resources目录下创建对应的默认配置文件：

• defaults.yml：所有环境通用的默认属性
• defaults-dev.yml：开发环境专属默认属性
• defaults-prod.yml：生产环境专属默认属性

步骤4：验证优先级 #

最终属性加载优先级（从高到低，后加载的会覆盖先加载的）：

• 命令行参数
• 业务项目的application-(profile).yml
• 业务项目的application.yml
• 库的defaults-(profile).yml
• 库的defaults.yml
• Spring Boot原生默认属性

完全满足需求：库提供基础默认值，业务项目可通过自身配置覆盖，同时保留Spring Boot原有加载逻辑。

额外适配说明 #

• 若需支持.properties格式，只需将YamlPropertySourceLoader替换为PropertiesPropertySourceLoader，并处理对应后缀的文件。
• 可根据实际需求调整属性源的插入位置，比如使用addAfter来调整优先级顺序。

内容的提问来源于stack exchange，提问作者Blake M.