Spring Boot 2.4.5测试运行时active profile配置加载异常问题

API 探路者

2026-8-27

问题背景

运行环境：Spring Boot 2.4.5
故障表现：运行仓库层集成测试时配置加载逻辑异常，未读取src/test/resources目录下的测试配置，反而加载了src/main/resources路径下的application-local.properties，启动日志明确显示当前激活profile为local
已尝试无效方案：在IntelliJ IDEA的Run/Debug Configurations中，分别配置SPRING.PROFILES.ACTIVE、spring.profiles.active、SPRING_PROFILES_ACTIVE参数值为test，均未生效
现有测试类注解配置：

@ExtendWith(SpringExtension.class)
@SpringBootTest
@TestPropertySource(locations = {"classpath:application-integration.properties"})
class StatusRepositoryIntegrationTest {

关键启动日志片段：

2022-06-30 21:58:39.961  INFO   --- [    Test worker] .b.t.c.SpringBootTestContextBootstrapper : Found @SpringBootConfiguration company.status.dashboard.api.App for test class dataset.status.dashboard.api.repository.StatusRepositoryIntegrationTest
2022-06-30 21:58:40.183  INFO 69695 --- [    Test worker] .StatusRepositoryIntegrationTest : Starting StatusRepositoryIntegrationTest using Java 11.0.15 on C12346 with PID 69695 (started by alex in /Users/alex/projects/status-dashboard-api)
2022-06-30 21:58:40.183  INFO 69695 --- [    Test worker] .StatusRepositoryIntegrationTest : The following profiles are active: local

根因分析

Spring Boot 2.4版本重构了配置文件加载优先级逻辑，@TestPropertySource默认仅加载指定路径的属性文件，不会覆盖上下文初始化阶段就确定的激活profile配置。如果主工程提前通过配置文件、硬编码指定了spring.profiles.active=local，测试层传参优先级不足时会被直接覆盖。
当前测试类注解只声明了要加载application-integration.properties，没有显式指定测试场景要激活的profile，Spring上下文启动时会优先读取主工程main目录下配置的active profile，因此始终加载main目录下的local环境配置。
若IDEA未将src/test/resources标记为测试资源根目录，编译阶段测试资源不会被加入测试类路径，Spring会直接读取main目录下的配置文件。
IDEA运行配置参数填写位置错误、格式不符合规范（例如VM参数漏写-D前缀、环境变量使用点号分隔命名），也会导致profile参数设置不生效。

解决方案

按以下顺序逐步骤排查修复：

修正测试类注解，强制指定测试场景激活的profile，优先使用Spring Test提供的@ActiveProfiles注解，该注解专门用于测试环境profile指定，优先级高于主工程配置，修改后注解示例：
```
@ExtendWith(SpringExtension.class)
@SpringBootTest
@ActiveProfiles("test") // 强制激活test profile，会覆盖主工程配置的local
@TestPropertySource(locations = {"classpath:application-integration.properties"})
class StatusRepositoryIntegrationTest {
```
如果你希望直接加载application-integration.properties对应的profile，也可以将@ActiveProfiles的值改为integration，Spring会自动识别并加载classpath下的application-integration.properties配置。
校验IDEA资源目录配置：
- 打开项目结构设置，找到src/test/resources目录，确认其被标记为Test Resources Root（测试资源根目录）；如果未标记，右键该目录选择Mark Directory as > Test Resources Root即可。
- 清理历史编译缓存：依次点击IDEA菜单栏Build > Rebuild Project，如果是Maven项目执行mvn clean test命令，Gradle项目执行gradle clean test命令，清除旧的编译缓存避免旧配置干扰。
修正IDEA运行配置参数格式：
- 若通过VM Options指定profile，参数必须写为-Dspring.profiles.active=test，不能漏写-D前缀。
- 若通过环境变量指定profile，参数名必须为全大写下划线分隔格式SPRING_PROFILES_ACTIVE=test，不能使用点号分隔的命名格式。
排查主工程硬编码配置：
检查主启动类company.status.dashboard.api.App中是否存在SpringApplication.setAdditionalProfiles("local")、System.setProperty("spring.profiles.active", "local")这类硬编码指定profile的逻辑，如果存在，@ActiveProfiles注解的配置会优先于这类硬编码生效，无需修改主代码。
验证修复结果：
重启测试，观察启动日志中The following profiles are active:后的值为你指定的test/integration即表示配置生效，此时Spring会优先读取test资源目录下的对应配置文件，不会再加载main目录下的application-local.properties。

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