@configurationproperties是读取yaml中list和嵌套map的推荐方式，支持类型安全、校验与ide提示；@value仅适用于顶层简单结构，无法解析多层嵌套；手动解析需用snakeyaml拍平为点分路径map以实现动态访问。
Spring Boot 读取 YAML 中的列表（List）和嵌套 Map，核心在于配置写法与 Java 端绑定方式的匹配。YAML 的缩进结构天然适合表达层级关系，但 Java 不会自动“理解”这种嵌套——必须通过明确的类型声明或解析逻辑来承接。
用 @ConfigurationProperties 绑定嵌套结构（推荐）
适合结构固定、可预定义的配置，类型安全、支持校验、IDE 友好。
- YAML 示例（含 List 和嵌套 Map）：
app:
features:
- login
- payment
- notification
services:
user-service:
timeout: 5000
retries: 3
order-service:
timeout: 8000
retries: 2- 对应 Java 配置类（Lombok 简化）：
@Component
@ConfigurationProperties(prefix = "app")
@Data
public class AppProperties {
private List<string> features;
private Map<string serviceconfig> services;
<pre class="brush:java;toolbar:false;">@Data
public static class ServiceConfig {
private long timeout;
private int retries;
}
}
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 使用时直接注入：
@Autowired
private AppProperties appProperties;
<p>// 获取：appProperties.getFeatures() → ["login", "payment", ...]
// 获取：appProperties.getServices().get("user-service").getTimeout() → 5000</p>用 @Value 快速读取简单 List 或扁平 Map
适合临时、轻量、非嵌套场景；不推荐用于多层嵌套，因为 @Value 本身不解析嵌套结构。
- 读取 YAML 中的顶层 List（如
app.features）：
app:
features:
- a
- b
- c@Value("${app.features}")
private List<string> features; // ✅ Spring Boot 2.4+ 原生支持</string>- 读取扁平 Map（需 SPEL）：
app:
envs:
dev: http://localhost:8080
prod: https://api.example.com@Value("#{${app.envs}}")
private Map<string string> envs; // ✅ 解析为 {dev=..., prod=...}</string>- ⚠️ 注意：@Value 无法直接读取
app.services.user-service.timeout这类嵌套路径，它只认顶层键名或 SPEL 表达式，不递归解析 YAML 树。
手动解析任意嵌套 YAML（动态/未知结构）
当配置结构不固定、需运行时动态获取任意路径值（如配置中心客户端），可用 SnakeYAML 手动加载并“拍平”：
- 将 YAML 转为嵌套 Map：
Yaml yaml = new Yaml(); Map<string object> raw = yaml.loadAs(inputStream, Map.class);</string>
- 再递归拍平为
Map<string object></string>，键为点分路径（如"app.services.user-service.timeout"）：
Map<string object> flat = flatten(raw, "");
// flat.get("app.services.user-service.timeout") → 5000</string>- 这样就能用任意字符串路径查值，无需提前定义 Java 类。
常见踩坑提醒
- 缩进必须用空格，不能用 Tab —— YAML 对缩进敏感，Tab 会导致解析失败或静默忽略。
- @ConfigurationProperties 类必须加 @Component 或 @EnableConfigurationProperties —— 否则不会被 Spring 扫描绑定。
- List 元素若含对象（如 fruits 列表里有 name/price），不能用 @Value 直接注入 —— 必须走 @ConfigurationProperties + 内部类。
-
中文或特殊字符做 Map key 时，YAML 中建议加引号，例如：
"用户服务": {timeout: 3000}。
