yaml列表在spring boot中可映射为java list，需满足三点：规范写法（-后空格+缩进对齐）、java类中声明明确泛型类型（如list或list）、启用@configurationproperties并注册为bean。
YAML 列表在 Spring Boot 中能直接映射为 Java 的 List，但关键在于写法规范、类结构匹配，以及启用正确的绑定机制。不是所有写法都能被自动识别，尤其当列表嵌套对象时，容易因类型推断失败而报错（比如 “Cannot convert value of type String to required type…”）。
YAML 列表基础写法必须规范
YAML 中列表项统一以 - 开头，后跟一个空格，再写内容；所有项缩进需严格对齐，否则解析会出错或被忽略：
- ✅ 正确（字符串列表）：
server:
supported-languages:
- English
- Chinese
- Spanish - ✅ 正确（对象列表）：
person:
dogList:
- name: 旺财
age: 6
- name: 小黑
age: 3 - ❌ 错误：缩进不一致、漏空格、用 tab 混合空格、- 后没空格，都可能导致解析失败或字段为空。
Java 类中必须声明明确的泛型类型
Spring Boot 依赖字段的泛型信息做类型转换。仅写 List 或 List<object></object> 无法支持嵌套对象映射，必须指定具体类型：
- ✅ 字符串列表：
private List<string> supportedLanguages;</string> - ✅ 对象列表：
private List<dog> dogList;</dog>（且Dog类需有无参构造 + getter/setter） - ❌ 不推荐：
private List dogList;或private List<object> dogList;</object>—— Spring 无法推断内部字段，会转成 LinkedHashMap 或抛异常。
必须启用 @ConfigurationProperties 并注册为 Bean
仅加注解不够，还需确保类被 Spring 容器管理，并开启配置绑定：
- 加
@Component或@Configuration注册为 Bean； - 加
@ConfigurationProperties(prefix = "person")，前缀要与 YAML 层级完全对应； - 确保
spring-boot-configuration-processor依赖已引入（用于编译期元数据生成，非必需但强烈建议）； - 若使用 Lombok，
@Data或@Setter + @Getter必须存在，否则 setter 缺失导致绑定失败。
特殊情况：用 @Value 解析简单字符串列表
如果只是读取逗号分隔的单行字符串（如 whitelist: /api,/health,/actuator），可用 @Value 配合 SpEL：
@Value("#{'${system.whitelist}'.split(',')}") private List<string> whitelist;</string>- 注意：这种方式不支持嵌套对象，也不支持校验和松散绑定，仅适合轻量、扁平配置。
