yamlmapper 解析带点号（.）的嵌套键时的正确用法：jackson 的 yamlmapper 默认不将点号（`.`）视为路径分隔符，而是将其作为普通键名的一部分；若 yaml 中使用 `formatting.template` 这类扁平键，需配合 json pointer `/formatting.template` 而非 `/formatting/template` 才能正确定位。
在使用 Jackson 的 YAMLMapper 读取 YAML 配置时，一个常见误区是混淆 YAML 原生语法结构 与 Spring Boot 的属性扁平化规则。YAML 本身将 formatting.template: 视为一个单一、合法的映射键（key），而非嵌套对象——也就是说，它等价于：
"formatting.template":
fields:
- name: birthdate
type: java.lang.String
subType: java.util.Date
lenght: 10此时，该键名中包含字面量 .，并非语法意义上的层级分隔符。因此，若你调用：
mapper.readerFor(FormattingConfigurationProperties.class)
.at("/formatting/template") // ❌ 错误：试图按嵌套路径查找
.readValue(inputStream);YAMLMapper 会尝试在根对象下查找名为 formatting 的对象，再在其内部查找 template 字段——但实际 YAML 根层只有一个键 "formatting.template"，导致解析器找不到对应节点，最终抛出 MismatchedInputException: No content to map due to end-of-input。
✅ 正确做法是：严格匹配 YAML 中定义的实际键结构。若使用扁平键 formatting.template:，JSON Pointer 必须写为：
.at("/formatting.template") // ✅ 正确：精确匹配键名（含点号）完整修正后的读取方法如下：
private static FormattingConfigurationProperties buildFormattingConfigurationProperties() throws IOException {
InputStream inputStream = new FileInputStream(
new File("./src/test/resources/application_formatting.yaml")
);
YAMLMapper mapper = new YAMLMapper();
mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
mapper.enable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);
return mapper.readerFor(FormattingConfigurationProperties.class)
.at("/formatting.template") // ← 关键修正：使用带点的完整键名
.readValue(inputStream);
}⚠️ 注意事项：
- YAML 规范中 . 不是特殊字符，无需转义；a.b 和 "a.b" 在语义上完全等价。
- Spring Boot 的 @ConfigurationProperties 自动绑定机制会对 YAML 进行“属性式重解析”，把 formatting.template.fields[0].name 映射为嵌套 Java 对象——但这属于 Spring 框架层的转换逻辑，不适用于直接使用 Jackson YAMLMapper 的场景。
- 若你同时支持两种 YAML 格式（扁平键 vs 多级缩进），建议统一采用标准嵌套格式（即 formatting:\n template:\n fields:），更符合 YAML 语义，也避免 JSON Pointer 表达歧义。
- YAMLMapper 的 .at() 方法接收的是 JSON Pointer 字符串，其路径分隔符始终为 /，与 YAML 键名内容无关。
总结：不要假设 YAML 键中的 . 具有路径含义；YAMLMapper 是忠实解析 YAML AST 的工具，而非 Spring 风格的属性处理器。精准匹配键名 + 正确 JSON Pointer，是解决此类 MismatchedInputException 的根本方式。
