在 Spring Boot 里，想用 YAML 把一组配置一次性注入进去，关键就在于用好 @ConfigurationProperties 和结构化配置这套机制。

核心在于三点：配置层级、前缀名称、字段类型必须严丝合缝地对应上。对齐之后，不仅能支持松散绑定，还能把复杂类型统一封装起来，顺带接入 JSR-303 校验。

如果想用 YAML 做一组配置的批量注入，真正的关键是让 @ConfigurationProperties 和结构化配置配合起来，而不是继续一个个去写 @Value。

重点从来不是“写得多不多”，而是层级有没有理顺、前缀有没有配准准确、类型能不能一一对上。

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

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

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

对应 Ja va 类时，字段名、嵌套层级、集合类型都要保持一致。

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

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

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

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

Ja va 中字段仍用标准驼峰：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"

对应 Ja va 类中可定义为：

• List urls
• Map pools
• List auth

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

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

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

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

Ja va 类示例：

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

《夸克》非常好用的免费AI浏览器

下载APP查看