Spring Boot 中用 YAML 批量注入依赖的核心是 @ConfigurationProperties 配合结构化配置，需确保层级、前缀、类型三者对齐，支持松散绑定、复杂类型封装及 JSR-303 校验。

Spring Boot 中用 YAML 实现批量依赖注入，核心是 @ConfigurationProperties 配合结构化配置，避免逐个写 @Value。关键不在“多写”，而在“写对层级、配准前缀、类型对齐”。

配置文件写法要对齐 Java 类结构

YAML 的缩进即对象嵌套关系。比如要注入一个 Person 对象及其地址列表：

person:
  name: 张三
  age: 28
  address:
    - city: 北京
      district: 朝阳区
    - city: 上海
      district: 徐汇区

对应 Java 类需保持字段名、嵌套层级、集合类型一致：

• person 类必须加 @ConfigurationProperties(prefix = "person")
• address 字段应为 List<Address> 类型，且 Address 类有 city 和 district 字段
• 类上必须加 @Component 或通过 @EnableConfigurationProperties 注册为 Bean

松散绑定（Relaxed Binding）让命名更自由

YAML 键名不强制驼峰，支持多种写法自动映射到 Java 字段：

my-app:
  server-port: 8080          # kebab-case → serverPort
  max_connection_count: 100  # snake_case → maxConnectionCount
  is_debug_enabled: true     # snake_case → isDebugEnabled

Java 中字段仍用标准驼峰：serverPort、maxConnectionCount、isDebugEnabled，Spring Boot 自动完成转换。

复杂类型封装支持 Map、List、嵌套对象混合

一行写完简单结构，也能清晰表达多层嵌套：

database:
  urls: [jdbc:mysql://a, jdbc:mysql://b]
  pools:
    default: {max-active: 20, min-idle: 5}
    backup:  {max-active: 10, min-idle: 2}
  auth:
    - username: admin
      password: "pwd@123"
    - username: reader
      password: "r3ad#2024"

对应 Java 类中可定义为：

• List<String> urls
• Map<String, PoolConfig> pools
• List<AuthConfig> auth

无需额外解析逻辑，Spring Boot 自动完成类型推导与实例化。

启用 JSR-303 校验让注入更可靠

在配置类上加 @Validated，字段加校验注解，启动时就报错，不等运行才暴露问题：

person:
  name: ""     # 触发 @NotBlank 报错
  age: -5      # 触发 @Min(0) 报错

Java 类示例：

• @NotBlank private String name;
• @Min(0) @Max(150) private Integer age;
• 类上加 @Validated，且确保 spring-boot-starter-validation 在 classpath 中