Spring Boot测试类加载配置文件失败，@Value注入属性为null求助

嘿，我之前写Spring Boot测试的时候也碰到过一模一样的情况——主代码里@Value用得顺风顺水，到了测试类里直接变成null，当时差点挠破头。咱们一步步排查，应该很快能解决：

1. 确认@SpringBootTest的上下文配置是否正确 #

你说测试类标注了@SpringBootTest并指向自身，但这里有个容易踩的坑：如果你的测试类没有@SpringBootApplication注解（这个注解一般在主启动类上），Spring可能没法正确初始化完整的ApplicationContext。

正确的姿势应该是指定你的主启动类作为上下文入口，比如：

@SpringBootTest(classes = YourMainApplication.class)
class MainTest {
    // ... 你的测试代码
}

这样Spring会按照主启动类的组件扫描规则加载上下文，测试配置文件也能被正确识别。

2. 检查测试配置文件的加载规则 #

如果你的测试配置不是默认的application.properties，而是自定义命名（比如my-test-config.properties）或者基于profile的配置（比如application-test.properties），得明确告诉Spring要加载它：

• 要是用了profile配置：在测试类上加@ActiveProfiles("test")，同时确保src/test/resources/application-test.properties存在，Spring会自动激活test环境并加载对应配置。
• 要是自定义命名的配置文件：用@TestPropertySource指定路径：

  @SpringBootTest(classes = YourMainApplication.class)
  @TestPropertySource(locations = "classpath:my-test-config.properties")
  class MainTest {
      // ...
  }
  

3. 核对属性名的拼写 #

别嫌啰嗦，这是最容易忽略的点！仔细比对@Value("${some.property.present.in.that.file}")里的属性名，和测试配置文件里的键是否完全一致——大小写、下划线、点号一个都不能错。比如配置里是some.property.present.in.that.file，代码里多打了个e变成some.property.present.in.that.filee，那肯定返回null。

4. 用Environment辅助调试 #

要是不确定配置到底有没有加载，可以注入Environment对象直接读取属性，帮你判断是配置没加载，还是@Value注入的问题：

@SpringBootTest(classes = YourMainApplication.class)
@ActiveProfiles("test")
class MainTest {

    @Value("${some.property.present.in.that.file}")
    private String prop;

    @Autowired
    private Environment env;

    @Test
    void checkPropertyLoading() {
        String envProp = env.getProperty("some.property.present.in.that.file");
        System.out.println("从Environment读取的属性：" + envProp);
        System.out.println("从@Value注入的属性：" + prop);
        // 如果envProp有值，说明配置加载了，问题在@Value注入；如果envProp也是null，说明配置没加载
    }
}

5. 排除其他干扰因素 #

• 检查字段修饰符：@Value可以注入private字段，但如果字段是static或final修饰的，Spring没法完成注入，会保持null。
• 确认测试依赖完整：确保pom.xml（或build.gradle）里引入了spring-boot-starter-test，这个依赖包含了Spring测试所需的所有核心组件。
• 检查配置覆盖：系统属性、环境变量或者命令行参数可能会覆盖测试配置的属性，测试前可以清理一下这些外部配置。

我当时就是漏加了@ActiveProfiles("test")，导致Spring加载的是主环境配置，测试配置根本没生效，折腾了好半天😂

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