Spring Boot 配置加载：解析 YAML 列表如何映射为系统变量 List

Spring Boot 的 YAML 配置虽然方便，但一到列表映射就容易翻车——不是值没读进去，就是抛个“Cannot convert value of type String to required type”的异常。说实话，根本原因往往就那么三点：写法对不对、类声明够不够明确、绑定机制有没有真正生效。下面咱们一个个拆开看。

从最表层的问题说起，很多开发者把 YAML 写成了 JSON 的缩进版，结果列表项少了个空格或者缩进没对齐，Spring 直接忽略——连报错都不给，只留一个空 List 让你怀疑人生。

YAML 列表基础写法必须规范

YAML 里列表项的写法很死板：每个项目必须用 - 开头，后面紧跟一个空格，再写实际内容。所有项目缩进必须严格对齐——混合 Tab 和空格是大忌。来看几个对比：

• ✅ 正确（字符串列表）：
  server:
supported-languages:
- English
- Chinese
- Spanish
• ✅ 正确（对象列表）：
  person:
dogList:
- name: 旺财
age: 6
- name: 小黑
age: 3
• ❌ 错误：缩进不一致、漏空格、用 Tab 混合空格、或者 - 后没加空格，都会导致解析失败或字段为空；更坑的是，有时候连错误提示都没有。

Ja va 类中必须声明明确的泛型类型

Spring Boot 做类型转换时，完全依赖字段的泛型信息。光写个 List 或者 List