@configurationproperties 失效

@ConfigurationProperties 注解在 Spring Boot 中用于将外部配置文件（如 application.properties 或 application.yml）中的属性绑定到一个 Java 类上。如果你发现 @ConfigurationProperties 失效，可能是以下几个原因造成的：

基础概念

@ConfigurationProperties 是一个用于声明属性绑定的注解，它可以与 @Component 或 @Configuration 注解一起使用，以便 Spring 容器能够识别并创建相应的 Bean。

可能的原因及解决方法

缺少必要的依赖：确保你的项目中包含了 spring-boot-configuration-processor 依赖，这个依赖可以帮助你在编译时生成元数据文件，提高配置的智能提示。
缺少必要的依赖：确保你的项目中包含了 spring-boot-configuration-processor 依赖，这个依赖可以帮助你在编译时生成元数据文件，提高配置的智能提示。
未启用配置属性支持：在你的主配置类或启动类上添加 @EnableConfigurationProperties 注解，并指定你的配置属性类。
未启用配置属性支持：在你的主配置类或启动类上添加 @EnableConfigurationProperties 注解，并指定你的配置属性类。
配置属性类未被 Spring 管理：确保你的配置属性类上有 @Component 或者被 @ConfigurationProperties 注解的类被 Spring 容器管理。
配置属性类未被 Spring 管理：确保你的配置属性类上有 @Component 或者被 @ConfigurationProperties 注解的类被 Spring 容器管理。
配置文件中的属性名不匹配：检查你的 application.properties 或 application.yml 文件中的属性名是否与配置属性类中的字段名相匹配，并且遵循正确的命名规则。
配置文件中的属性名不匹配：检查你的 application.properties 或 application.yml 文件中的属性名是否与配置属性类中的字段名相匹配，并且遵循正确的命名规则。
配置文件未被正确加载：确保你的配置文件位于正确的位置（通常是 src/main/resources 下），并且文件名和扩展名正确。
使用了错误的注解：如果你在配置属性类上使用了 @Configuration 而不是 @Component，请确保你也添加了 @EnableConfigurationProperties 注解。

应用场景

@ConfigurationProperties 常用于将复杂的配置信息绑定到一个 Java 对象上，这样可以更方便地在代码中使用这些配置，而不是直接从配置文件中读取。它适用于任何需要从外部配置文件中读取设置的应用程序。

示例代码

假设我们有一个配置属性类 AppConfig，它将绑定 application.properties 中以 app 开头的属性。

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "app")
public class AppConfig {
    private String name;
    private String version;

    // getters and setters
}

在 application.properties 中：

app.name=MyApp
app.version=1.0.0

在你的服务类中，你可以直接注入 AppConfig 并使用它：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class MyService {

    private final AppConfig appConfig;

    @Autowired
    public MyService(AppConfig appConfig) {
        this.appConfig = appConfig;
    }

    public void printConfig() {
        System.out.println("App Name: " + appConfig.getName());
        System.out.println("App Version: " + appConfig.getVersion());
    }
}

确保你的项目结构和配置正确，这样 @ConfigurationProperties 就能正常工作了。如果仍然遇到问题，可以检查日志输出或使用调试工具来确定具体的错误原因。