YAML本身不执行注入，真正的Setter自动注入由@ConfigurationProperties机制完成；需满足YAML缩进规范、Java类含public setter、@Component与prefix匹配三者协同。
YAML 文件本身不执行注入，它只是提供结构化配置数据；真正的“Setter 自动注入”由 Spring Boot 的 @ConfigurationProperties 机制完成，前提是 Java 类满足特定规则。核心不是 YAML 写法，而是「YAML 结构 + Java 类定义 + 注解绑定」三者协同。
YAML 配置需满足的格式规范
YAML 是纯数据载体，其写法直接影响能否被正确映射：
- 使用空格缩进表示嵌套层级（严禁 Tab），相同层级的 key 缩进量必须一致
- 键名后冒号 必须紧跟一个空格，例如
name: jaywee（name:jaywee会解析失败） - 键名支持短横线（
user-name）或驼峰（userName），Spring Boot 自动转为 camelCase 匹配字段 - 列表用
-或方括号，如roles: [admin, user]或roles: - admin - user - Map 使用缩进嵌套，如
map: k1: v1 k2: v2，等价于map: {k1: v1, k2: v2}
Java 类必须具备的 Setter 条件
Spring Boot 通过反射调用 setter 方法完成属性赋值，因此类必须满足：
- 类上标注
@ConfigurationProperties(prefix = "xxx")，且该类被 Spring 管理（通常加@Component） - 每个需要注入的字段，必须有**公开的、无参的 setter 方法**，方法名严格遵循 JavaBean 规范：
setXxx()，其中Xxx是字段名首字母大写 - 字段类型需与 YAML 值类型兼容（如 YAML 中
age: 7→ Java 字段应为Integer或int） - 嵌套对象字段（如
private Pet pet;）对应 YAML 中同名缩进块，且该嵌套类也需有完整 setter - 集合类建议使用接口类型（
List<String>、Map<String, Object>），Spring 可自动实例化
启用注入的必要配置项
仅写 YAML 和 Java 类还不够，还需激活配置绑定机制：
- 主启动类或配置类上添加
@EnableConfigurationProperties(Person.class)（显式启用） - 或确保类上有
@Component+@ConfigurationProperties，且 Spring 扫描到了该类 - Spring Boot 3.2+ 推荐搭配
@Validated启用 JSR-303 校验，配合@NotBlank等注解做注入时校验 - 若使用 Lombok，可用
@Data或@Setter自动生成 setter，但需确认生成方法签名符合要求（如布尔字段生成setGender(Boolean)而非setGender(boolean)更稳妥）
常见失败原因与检查点
注入失败往往不是 YAML 写错，而是绑定链断裂：
- YAML 中键名拼写错误或缩进错位（如把
pet:写成pet:多两个空格，导致脱离person层级） - Java 字段名为
userName，但 YAML 写成username且未加@ConfigurationProperties的松散绑定支持 - 缺少 setter：字段有
private Date birthday;，但没写public void setBirthday(Date birthday) - 类未被 Spring 扫描到：忘记加
@Component，或包路径不在组件扫描范围内 - prefix 值与 YAML 最外层 key 不匹配，例如 YAML 是
app: service: name: demo，但注解写成@ConfigurationProperties(prefix = "service")
