如何在Spring Boot测试类中编程式切换激活配置文件并解决属性读取问题？

问题根源 #

Gradle的test任务默认会启动独立JVM进程运行测试，直接在命令行或build.gradle中设置的系统属性不会自动传递到测试JVM，导致你的自定义解析器无法读取到spring.profiles.active属性。

解决方案 #

1. 配置Gradle测试任务传递系统属性 #

修改build.gradle（或build.gradle.kts）的test任务，将外部传入的系统属性传递到测试JVM中：

Groovy DSL（build.gradle）

test {
    // 传递命令行传入的所有系统属性到测试JVM
    systemProperties System.getProperties()
    
    // 也可以仅传递指定属性，避免无关属性干扰
    // systemProperty 'spring.profiles.active', System.getProperty('spring.profiles.active', 'ITProfile')
}

Kotlin DSL（build.gradle.kts）

tasks.test {
    // 传递所有系统属性到测试JVM
    systemProperties(System.getProperties().mapKeys { it.key.toString() })
    
    // 或仅传递目标属性
    // systemProperty("spring.profiles.active", System.getProperty("spring.profiles.active", "ITProfile"))
}

2. 通过命令行切换测试配置 #

配置完成后，执行测试时通过-D参数指定要激活的配置文件：

# 运行默认IT测试
./gradlew test

# 切换为E2E测试配置
./gradlew test -Dspring.profiles.active=E2EProfile

3. 优化自定义解析器（可选） #

如果需要同时支持环境变量（适配CI等场景），可以扩展解析器逻辑：

public class SystemPropertyActiveProfileResolver implements ActiveProfilesResolver {

  private final DefaultActiveProfilesResolver defaultActiveProfilesResolver =
      new DefaultActiveProfilesResolver();

  @Override
  public String[] resolve(Class<?> testClass) {
    final String springProfileKey = "spring.profiles.active";
    // 优先读取系统属性，无值则读环境变量
    String profile = System.getProperty(springProfileKey);
    if (profile == null) {
        profile = System.getenv(springProfileKey);
    }
    return profile != null ? profile.split("\\s*,\\s*") 
                          : defaultActiveProfilesResolver.resolve(testClass);
  }
}

4. 简化方案：使用Spring内置解析器（可选） #

Spring Boot已经内置了SystemProfileActiveProfilesResolver，逻辑和你自定义的解析器完全一致，无需自己实现：

@ActiveProfiles(value = "ITProfile", resolver = SystemProfileActiveProfilesResolver.class)

验证方式 #

在解析器中添加打印语句，确认属性是否被正确读取：

@Override
public String[] resolve(Class<?> testClass) {
    final String springProfileKey = "spring.profiles.active";
    String systemProp = System.getProperty(springProfileKey);
    String envProp = System.getenv(springProfileKey);
    System.out.println("系统属性spring.profiles.active: " + systemProp);
    System.out.println("环境变量spring.profiles.active: " + envProp);
    
    // 原有逻辑...
}

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