Spring Boot中MockMvc测试REST Controller时环境属性为null的原因

这种情况我之前在JHipster项目里也碰到过，核心原因大多是单元测试的Spring上下文没有正确加载你的配置文件，或者测试类的注解配置不对，导致application.yml里的属性没被注入进来。下面分几种常见情况和解决办法：

1. 测试类缺少加载配置的注解 #

如果你的测试类只加了@WebMvcTest，默认情况下它只会加载Web层的Bean，不会自动加载src/main/resources下的全局配置。JHipster生成的测试类有时候会简化配置，容易忽略这一点。

解决办法： #

• 如果你想加载完整的Spring上下文（适合集成测试），把@WebMvcTest换成@SpringBootTest，再加上@AutoConfigureMockMvc启用MockMvc：

@SpringBootTest
@AutoConfigureMockMvc
public class YourControllerTest {
    // 测试代码
}

• 如果你只想做轻量的Web层测试，不想加载完整上下文，可以在@WebMvcTest里用@TestPropertySource指定配置文件路径，或者导入你的属性配置类：

@WebMvcTest(YourController.class)
@TestPropertySource(locations = "classpath:application.yml")
public class YourControllerTest {
    // 测试代码
}

2. 属性配置类未被正确扫描 #

如果你的属性是通过@ConfigurationProperties绑定的（比如JHipster常用的配置方式），测试环境可能没扫描到这个配置类，导致属性无法注入。

解决办法： #

• 在测试类里用@Import导入你的属性配置类，或者直接在@TestPropertySource里指定测试用的属性值：

@WebMvcTest(YourController.class)
@Import(YourProperties.class)
@TestPropertySource(properties = "your.prefix.property1=test_value")
public class YourControllerTest {
    // 测试代码
}

3. 配置文件路径或环境问题 #

测试环境默认优先读取src/test/resources下的配置，如果这个目录下没有application.yml，或者没配置property1，就会返回null。另外如果你的应用用了多环境配置（比如application-dev.yml），测试时没指定激活环境也会读不到正确属性。

解决办法： #

• 在测试类里用@ActiveProfiles指定要激活的环境：

@SpringBootTest
@AutoConfigureMockMvc
@ActiveProfiles("dev")
public class YourControllerTest {
    // 测试代码
}

• 或者在src/test/resources下创建一份application.yml，写入需要测试的属性，测试时会优先读取这份配置。

4. JHipster特定配置加载逻辑 #

JHipster生成的项目有自己的配置加载机制，部分测试需要继承它提供的基础测试类（比如AbstractSpringBootTest），或者用@TestConfiguration导入必要的配置组件，才能确保配置被正确加载。

解决办法： #

• 参考JHipster生成的其他测试类的注解配置，比如很多集成测试会继承AbstractSpringBootTest，复用这套配置加载逻辑。

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