Spring Boot：如何用@TestPropertySource为Service注入测试属性

可能的原因及对应解决方案 #

1. 规范测试配置的加载方式 #

如果你的application-test.properties放在src/test/resources下，优先用激活test环境的方式加载配置，比@TestPropertySource更稳妥，Spring会自动识别并加载测试目录下的配置文件：

@SpringBootTest(properties = {"spring.profiles.active=test"})
public class ShortURLServiceTest {
    // 测试代码
}

如果一定要用@TestPropertySource，确保路径是类路径正确引用：

@SpringBootTest
@TestPropertySource(locations = "classpath:application-test.properties")
public class ShortURLServiceTest {
    // 测试代码
}

2. 确保Service被Spring容器管理 #

你的ShortURLService必须添加@Service（或@Component）注解，让Spring上下文扫描并实例化它；同时测试类里要通过@Autowired注入Service，绝对不能手动new对象——手动创建的实例不会被Spring处理，属性自然为null。
示例代码：

@Service
public class ShortURLService {
    @Value("${your.property.key}")
    private String targetProperty;
    
    // 业务方法
}

测试类注入方式：

@SpringBootTest(properties = {"spring.profiles.active=test"})
public class ShortURLServiceTest {
    @Autowired
    private ShortURLService shortURLService;
    
    @Test
    public void testPropertyInjection() {
        // 验证属性是否注入成功
        assertNotNull(shortURLService.getTargetProperty());
    }
}

3. 核对属性键的一致性 #

检查application-test.properties中的属性键，和ShortURLService里@Value注解中的键完全匹配，包括大小写、分隔符（比如.），拼写错误会直接导致注入失败。

4. 排除主配置干扰（可选） #

如果主配置application.properties中没有目标属性，或需要完全隔离测试环境，可以在测试类中强制指定配置文件位置：

@SpringBootTest
@TestPropertySource(
    locations = "classpath:application-test.properties",
    properties = {"spring.config.location=classpath:application-test.properties"}
)
public class ShortURLServiceTest {
    // ...
}

5. 刷新测试上下文（可选） #

如果Spring缓存了之前的测试上下文，导致配置未更新，可以添加@DirtiesContext强制刷新：

@SpringBootTest(properties = {"spring.profiles.active=test"})
@DirtiesContext(classMode = DirtiesContext.ClassMode.BEFORE_EACH_TEST_METHOD)
public class ShortURLServiceTest {
    // ...
}

内容的提问来源于stack exchange，提问作者İlkay Gunel