Spring Boot如何按指定优先级加载分层profiles配置文件

核心逻辑 #

Spring Boot 配置加载遵循「后加载的配置优先级更高，可覆盖先加载的同key配置」规则，我们只要控制加载顺序为：src/main/resources/application.yml → 根目录config/dev.yml → 根目录config/us/dev.yml即可实现需求，全程不需要修改现有项目目录结构。

方案一：使用spring.config.import（推荐，适配Spring Boot 2.4及以上版本） #

直接在现有application.yml顶部添加导入配置即可：

spring:
  config:
    import:
      # 可选配置加optional前缀，文件不存在也不会报错
      - optional:file:./config/${spring.profiles.active}.yml
      - optional:file:./config/us/${spring.profiles.active}.yml

启动项目时指定激活环境为dev：

java -jar your-project.jar --spring.profiles.active=dev

该方案实现最简单，不需要额外开发代码。

方案二：使用spring.config.location启动参数（适配Spring Boot 2.4以下版本） #

启动时直接指定配置文件加载顺序即可：

java -jar your-project.jar --spring.profiles.active=dev --spring.config.location=classpath:/application.yml,file:./config/dev.yml,file:./config/us/dev.yml

配置路径按从低优先级到高优先级排列，后列出的配置会自动覆盖前面的同key配置。

方案三：自定义配置加载处理器（无侵入，不需要修改启动参数） #

如果不想每次启动加参数，可以通过EnvironmentPostProcessor在代码层面固定加载规则：

1. 新增自定义配置加载类：

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.FileSystemResource;
import java.io.IOException;
import java.util.List;

public class CustomConfigLoadProcessor implements EnvironmentPostProcessor {
    private final YamlPropertySourceLoader yamlLoader = new YamlPropertySourceLoader();

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        // 获取当前激活的环境，默认取dev
        String activeProfile = environment.getActiveProfiles().length > 0 ? environment.getActiveProfiles()[0] : "dev";
        // 按优先级从低到高加载，后添加的配置优先级更高
        loadExternalConfig(environment, "./config/" + activeProfile + ".yml", "rootConfigSource");
        loadExternalConfig(environment, "./config/us/" + activeProfile + ".yml", "usRegionConfigSource");
    }

    private void loadExternalConfig(ConfigurableEnvironment environment, String filePath, String sourceName) {
        FileSystemResource configResource = new FileSystemResource(filePath);
        if (!configResource.exists()) {
            return;
        }
        try {
            List<PropertySource<?>> propertySources = yamlLoader.load(sourceName, configResource);
            for (PropertySource<?> ps : propertySources) {
                // 加入到配置源最前面，优先级最高
                environment.getPropertySources().addFirst(ps);
            }
        } catch (IOException e) {
            throw new RuntimeException("加载外部配置失败: " + filePath, e);
        }
    }
}

2. 在src/main/resources/META-INF/spring.factories中注册该处理器：

org.springframework.boot.env.EnvironmentPostProcessor=com.yourpackage.CustomConfigLoadProcessor

将类路径替换为你实际的包路径即可，项目启动时会自动按规则加载配置。

注意事项 #

• 三种方案都不需要修改现有目录结构，完全符合约束要求
• 只有同key的配置才会触发覆盖，不存在的key会自动合并保留
• 生产环境如果需要切换stg环境，只需要修改激活的profile为stg即可自动适配对应目录下的stg.yml

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