SpringBoot多激活Profile下@PropertySource配置文件路径配置问题

一、@PropertySource占位符支持的内容 #

@PropertySource 中的 ${...} 占位符仅支持简单的属性取值，直接对应Spring环境中的属性值，不支持遍历、条件判断这类复杂EL表达式。当多个Profile激活时，${spring.profiles.active} 会直接返回逗号拼接的字符串（比如 dev,test），导致配置文件路径变成 services/service-dev,test.properties，最终触发文件找不到的异常。

二、多Profile配置文件加载的可行方案 #

1. 利用SpringBoot原生特性忽略不存在的文件 #

保留原有的占位符写法，添加 ignoreResourceNotFound = true 属性，这样即使某个激活Profile对应的配置文件不存在，应用也不会启动失败，只会忽略该文件：

@Configuration
@PropertySource(value = "classpath:services/service-${spring.profiles.active}.properties", ignoreResourceNotFound = true)
public class MuPropertiesConfig {
    // 配置类内容
}

2. 自定义环境处理器实现精准加载 #

如果需要只加载指定Profile（dev、test、acc、prod）的配置文件，可以实现 EnvironmentPostProcessor，在应用启动时遍历激活的Profile，逐个匹配并加载对应文件：

public class CustomProfilePropertyLoader implements EnvironmentPostProcessor {
    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        List<String> activeProfiles = Arrays.asList(environment.getActiveProfiles());
        List<String> targetProfiles = Arrays.asList("dev", "test", "acc", "prod");
        
        activeProfiles.stream()
                .filter(targetProfiles::contains)
                .forEach(profile -> {
                    String configPath = "classpath:services/service-" + profile + ".properties";
                    try {
                        Resource resource = new ClassPathResource(configPath);
                        Properties properties = PropertiesLoaderUtils.loadProperties(resource);
                        environment.getPropertySources().addLast(new PropertiesPropertySource("service-" + profile, properties));
                    } catch (IOException e) {
                        // 按需处理加载异常
                        e.printStackTrace();
                    }
                });
    }
}

然后在 META-INF/spring.factories 中注册这个处理器：

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

3. 按Profile拆分配置类 #

为每个目标Profile单独创建配置类，通过 @Profile 指定生效条件：

// 基础配置类
@Configuration
@ConfigurationProperties(prefix = "service")
public class MuPropertiesConfig {
    // 属性字段
}

// dev环境专属配置
@Configuration
@Profile("dev")
@PropertySource("classpath:services/service-dev.properties")
public class DevMuPropertiesConfig extends MuPropertiesConfig {}

// test环境专属配置
@Configuration
@Profile("test")
@PropertySource("classpath:services/service-test.properties")
public class TestMuPropertiesConfig extends MuPropertiesConfig {}

三、总结 #

@PropertySource 的占位符不支持复杂EL逻辑，解决多Profile配置加载的核心思路要么利用SpringBoot原生的忽略机制，要么通过自定义处理器实现精准匹配，或者拆分配置类按Profile分别加载。

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