如何根据环境条件选择Spring的@TestPropertySource或@PropertySource？

方法一：利用条件配置类自动切换配置加载方式 #

不用在TestBase上直接写@PropertySource或@TestPropertySource，而是通过两个带条件的配置类，自动根据环境加载对应方式：

1. 编写CI环境的配置类，用@PropertySource加载配置，仅在CI环境生效：

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
import org.springframework.core.type.AnnotatedTypeMetadata;

@Configuration
@PropertySource("classpath:/test.properties")
@Conditional(CiTestConfig.CiEnvironmentCondition.class)
public class CiTestConfig {
    public static class CiEnvironmentCondition implements Condition {
        @Override
        public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
            // 多数CI平台（GitHub Actions、GitLab CI等）会自动设置CI=true环境变量
            return "true".equals(context.getEnvironment().getProperty("CI"));
        }
    }
}

2. 编写本地环境的配置类，用@TestPropertySource加载配置，仅在本地生效：

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.context.annotation.Configuration;
import org.springframework.test.context.TestPropertySource;
import org.springframework.core.type.AnnotatedTypeMetadata;

@Configuration
@TestPropertySource("classpath:/test.properties")
@Conditional(LocalTestConfig.LocalEnvironmentCondition.class)
public class LocalTestConfig {
    public static class LocalEnvironmentCondition implements Condition {
        @Override
        public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
            // 本地环境无CI变量或CI≠true时生效
            return !"true".equals(context.getEnvironment().getProperty("CI"));
        }
    }
}

3. 修改TestBase类，导入这两个配置类即可：

import org.springframework.context.annotation.Import;
import org.springframework.test.context.junit4.AbstractJUnit4SpringContextTests;

@Import({CiTestConfig.class, LocalTestConfig.class})
public class TestBase extends AbstractJUnit4SpringContextTests {
    // 原有代码不变
}

这样CI环境会自动加载CiTestConfig（用@PropertySource），本地IntelliJ运行时会加载LocalTestConfig（用@TestPropertySource），无需手动切换注解。

方法二：统一使用@TestPropertySource并调整CI配置 #

如果不想写额外配置类，可以尝试统一用@TestPropertySource，然后在CI的测试启动命令中添加参数，确保Spring Test上下文正确加载：

Maven测试命令：

mvn test -Dspring.test.context.enabled=true

Gradle测试命令：

./gradlew test -Dspring.test.context.enabled=true

多数情况下@TestPropertySource在CI不生效，是因为测试runner未正确初始化Spring Test上下文，添加该参数可强制启用测试上下文，让注解正常加载配置。

方法三：手动加载配置文件（最稳妥） #

完全绕过注解差异，在TestBase中手动加载配置文件，适用于所有环境：

import org.springframework.context.support.PropertySourcesPlaceholderConfigurer;
import org.springframework.core.io.ClassPathResource;
import org.springframework.test.context.junit4.AbstractJUnit4SpringContextTests;

public class TestBase extends AbstractJUnit4SpringContextTests {
    static {
        PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();
        configurer.setLocation(new ClassPathResource("test.properties"));
        configurer.postProcessBeanFactory(applicationContext.getBeanFactory());
    }
}

这种方式直接通过代码加载配置，不受注解环境差异影响，兼容性最强。

内容的提问来源于stack exchange，提问作者Tamás Horváth