为何使用@EnableConfigurationProperties后@ConfigurationProperties未自动注册为Bean？

问题重现 #

我编写了如下配置类、配置文件及单元测试，但运行测试时出现NoSuchBeanDefinitionException，无法自动注入MyProperties：

配置类代码 #

@ConfigurationProperties(prefix = "hello")
public class MyProperties {
    
    private String name;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

@EnableConfigurationProperties(MyProperties.class)
public class MyConfig {
}

配置文件（application.properties） #

hello.name=zhangsan

单元测试代码 #

@SpringBootTest
class SpringLearnApplicationTests {

    @Autowired
    private MyProperties myProperties;

    @Test
    void contextLoads() {
        System.out.println(myProperties.getName()); 
    }
}

异常信息 #

Caused by: org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.github.spring_learn.conf.MyProperties' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}

根据@EnableConfigurationProperties的文档说明：

Enable support for @ConfigurationProperties annotated beans. @ConfigurationProperties beans can be registered in the standard way (for example using @Bean methods) or, for convenience, can be specified directly on this annotation.

文档明确说可以通过该注解直接指定@ConfigurationProperties类注册Bean，但实际未生效。我尝试在MyProperties上添加@Component、@Bean或@Configuration注解手动注册，无需MyConfig类即可正常运行，这种方式更简便。

那既然@EnableConfigurationProperties无法自动注册Bean，它的作用到底是什么？

问题分析与解答 #

1. 你的代码失效的原因 #

@EnableConfigurationProperties本身确实可以注册指定的@ConfigurationProperties类为Bean，你遇到的问题大概率是MyConfig类没有被Spring的组件扫描机制发现。

Spring需要能扫描到标注了@EnableConfigurationProperties的配置类，才能触发后续的Bean注册逻辑。如果MyConfig所在的包不在SpringBoot默认的扫描路径下（比如主启动类的包层级高于MyConfig的包），或者没有给MyConfig添加@Configuration注解（标记它为配置类），Spring就不会处理这个类，自然不会注册MyProperties的Bean。

解决方法很简单：给MyConfig添加@Configuration注解，确保它能被Spring扫描到：

@Configuration
@EnableConfigurationProperties(MyProperties.class)
public class MyConfig {
}

2. @EnableConfigurationProperties的核心作用 #

它的价值并不只是替代@Component这类注册Bean的注解，而是有更特定的应用场景：

• 注册无@Component标记的配置类：如果是第三方Jar包中的@ConfigurationProperties类，你无法修改源码添加@Component，这时候就可以通过@EnableConfigurationProperties(ThirdPartyProps.class)直接将其注册为Spring Bean，并自动完成配置属性绑定。
• 显式激活配置属性绑定：虽然SpringBoot默认会自动处理@Component标记的@ConfigurationProperties类，但在某些自定义场景下（比如非自动装配的环境），需要显式通过@EnableConfigurationProperties来激活属性绑定逻辑。
• 配合@ConfigurationPropertiesScan批量处理：当你有多个@ConfigurationProperties类时，@ConfigurationPropertiesScan可以批量扫描指定包下的这类类，而@EnableConfigurationProperties则适合手动指定单个或少量类的场景。

简单来说，@Component是通用的Bean注册方式，而@EnableConfigurationProperties是专门针对@ConfigurationProperties类的注册+属性绑定的增强工具，在处理非自定义的配置类时优势明显。

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