必须为@configurationproperties类添加@component或通过@enableconfigurationproperties/@bean注册，确保其被spring容器管理并触发绑定；配置项层级须与prefix严格对齐，键名推荐kebab-case并自动转驼峰，或用@jsonproperty强制映射。
要在SpringBoot中让自动配置类正确读取application.yml里的配置项并注入到Bean中，必须让@ConfigurationProperties绑定机制与SpringBoot的自动装配生命周期协同工作——否则配置值始终为null或绑定失败。
确保配置类被Spring容器管理
在配置类上同时添加@Component和@ConfigurationProperties注解，例如：@Component @ConfigurationProperties(prefix = "app.db")。这一步是强制前提，【没有@Component或等效注册方式，@ConfigurationProperties不会触发绑定】。
检查该类是否位于@SpringBootApplication主类所在包或其子包下；若不在，需在启动类上显式添加@ComponentScan指定扫描路径。
运行项目后，通过@Autowired注入该配置类实例，调用toString()验证属性是否已填充。
配置文件键名与Java字段名匹配规则
方法一：采用kebab-case命名（推荐）
application.yml中写：
app:<br> db:<br> driver-class-name: com.mysql.cj.jdbc.Driver
Java字段名写为
private String driverClassName;——Spring Boot会自动将短横线转驼峰。
方法二：使用@JsonProperty强制映射
当字段名无法按规则推导时，在字段上加@JsonProperty("driver-class-name")，此时无需遵守命名转换规则。
注意：配置项层级必须与prefix完全对齐，多一级或少一级都会导致绑定失效。
启用配置绑定的两种等效方式
第一步：使用@Component + @ConfigurationProperties（最常用）
直接在POJO类上标注@Component和@ConfigurationProperties，Spring Boot启动时自动完成注册与绑定。
第二步：使用@EnableConfigurationProperties + @ConfigurationProperties（适合模块化场景）
在@Configuration类或主启动类上添加@EnableConfigurationProperties(MyDbProperties.class)，再单独定义MyDbProperties类并仅标注@ConfigurationProperties(prefix="app.db")。【此时MyDbProperties类不可加@Component，否则会注册两次Bean】。
第三步：用@Bean + @ConfigurationProperties声明式注册
在配置类中编写@Bean方法：@Bean @ConfigurationProperties("app.db") public MyDbProperties dbProperties() { return new MyDbProperties(); }——这种方式可控制实例创建时机，适合需要定制初始化逻辑的场景。
验证绑定是否成功
启动应用后，访问Actuator的/env端点（需引入spring-boot-starter-actuator），搜索对应prefix，确认配置项已加载到Environment中。
在Controller中注入配置类，打印对象内容；若字段仍为null或默认值，说明前缀拼写错误、配置文件未生效、或类未被组件扫描到。
在application.yml顶部添加spring: main: allow-bean-definition-overriding: true可避免因重复注册引发的启动异常（仅调试阶段启用）。
