为何@Value生效，@ConfigurationProperties却无法绑定属性？

核心原因 #

你猜的没错，@ContextConfiguration确实是问题所在。这个注解仅负责加载你指定的ConfigProperties类，但Spring Boot的@ConfigurationProperties绑定机制需要依赖特定的自动配置组件（比如ConfigurationPropertiesBindingPostProcessor）才能生效，而@ContextConfiguration默认不会引入这些Spring Boot核心配置组件，导致port、from字段无法完成自动绑定。

另外还要确认一个基础点：你的port、from字段是否有公共的getter和setter方法？@ConfigurationProperties是通过setter方法完成属性注入的，没有setter的话即使配置绑定机制生效也拿不到值。

解决方案 #

方案1：改用Spring Boot专用测试注解（推荐）

把测试类上的@ContextConfiguration替换成@SpringBootTest，它会自动加载完整的Spring Boot上下文，包括配置绑定所需的所有组件，同时会自动读取application.yaml配置。示例：

@SpringBootTest
public class ConfigPropertiesTest {
    @Autowired
    private ConfigProperties configProperties;

    // 测试逻辑
}

方案2：保留@ContextConfiguration，手动导入必要组件

如果必须用@ContextConfiguration，需要手动导入配置绑定的核心处理器，同时确保配置文件被加载：

@ContextConfiguration(classes = {ConfigProperties.class})
@Import(ConfigurationPropertiesBindingPostProcessor.class)
@PropertySource(value = "classpath:application.yaml", factory = YamlPropertySourceFactory.class)
public class ConfigPropertiesTest {
    @Autowired
    private ConfigProperties configProperties;

    // 测试逻辑
}

注意：这里需要自定义YamlPropertySourceFactory来解析yaml文件（因为默认@PropertySource不支持yaml），实现代码如下：

public class YamlPropertySourceFactory implements PropertySourceFactory {
    @Override
    public PropertySource<?> createPropertySource(String name, EncodedResource resource) throws IOException {
        YamlPropertiesFactoryBean factory = new YamlPropertiesFactoryBean();
        factory.setResources(resource.getResource());
        Properties properties = factory.getObject();
        return new PropertiesPropertySource(name != null ? name : resource.getResource().getFilename(), properties);
    }
}

方案3：检查ConfigProperties类的字段规范

确保port、from字段有公共的setter方法，示例：

@Component
@ConfigurationProperties(prefix = "sample.mail")
public class ConfigProperties {
    private String hostName;
    private Integer port;
    private String from;

    // 所有字段的getter和setter
    public String getHostName() { return hostName; }
    public void setHostName(String hostName) { this.hostName = hostName; }
    public Integer getPort() { return port; }
    public void setPort(Integer port) { this.port = port; }
    public String getFrom() { return from; }
    public void setFrom(String from) { this.from = from; }
}

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