Spring Boot @ConfigurationProperties配置手动实例化后取值为null如何解决

API 探路者

2026-9-29

问题根因

你手动在AnimalChooser中通过new AnimalProperties()创建的对象不属于Spring IoC容器的托管范围，只有Spring容器管理的@ConfigurationProperties类才会自动绑定application.yml中的配置值，手动实例化的对象只会使用代码中的默认初始化值，自然拿不到配置的name属性。

解决方案

步骤1：改造AnimalChooser，交给Spring托管并注入配置类

给AnimalChooser添加@Component注解，将其注册为Spring Bean，同时注入Spring已经完成属性绑定的AnimalProperties实例，不要手动new：

@Component
public class AnimalChooser {
    // 注入Spring托管的配置类，已经完成yml属性绑定
    private final AnimalProperties animalProperties;

    // 推荐用构造器注入，更符合Spring最佳实践
    public AnimalChooser(AnimalProperties animalProperties) {
        this.animalProperties = animalProperties;
    }
    
    public Animal getById(int id) {
        if(id == Tiger.ID) {
            return animalProperties.getTiger();
        } else {
            return animalProperties.getLion();
        }
    }
}

步骤2：改造测试类，注入AnimalChooser实例

测试类需要改为Spring Boot测试，注入Spring托管的AnimalChooser，不要自己new对象：

@SpringBootTest
@EnableConfigurationProperties(AnimalProperties.class)    
class AnimalChooserTest {
    // 注入Spring托管的AnimalChooser
    @Autowired
    private AnimalChooser animalChooser;
    
    @Test
    void shouldReturnCorrectNameForTiger() {
        Animal tiger = animalChooser.getById(1);
        assertEquals("Joe", tiger.getName());
    }
}