jackson 的 yamlmapper 默认不将点号（.）视为嵌套路径分隔符；它严格遵循 yaml 规范，将 `formatting.template` 视为一个完整键名而非嵌套结构，因此需配合正确的 json pointer 路径（如 `/formatting.template`）才能准确定位。
在使用 Jackson 的 YAMLMapper 解析 YAML 配置时，一个常见误区是认为 YAML 中的点号（.）天然表示嵌套层级（如 formatting.template.fields 等价于 formatting: template: fields:）。但YAML 本身并不将 . 当作语法分隔符——它只是一个普通字符。只有 Spring Boot 等框架在内部将 YAML 转为 Properties 结构时，才会把未转义的点号解释为层级分隔符。
因此，当你写如下 YAML：
formatting.template:
fields:
- name: birthdate
type: java.lang.String
subType: java.util.Date
lenght: 10YAML 解析器（包括 YAMLMapper）会将其解析为一个 单层映射，其 key 是字符串 "formatting.template"，value 是一个包含 fields 的对象。此时，若你仍使用 JSON Pointer /formatting/template（意图为“进入 formatting 对象 → 进入 template 对象”），就会因路径不匹配而触发 MismatchedInputException 或 No content to map due to end-of-input —— 因为实际根对象中根本不存在名为 formatting 的字段。
✅ 正确做法是：保持 YAML 键名原样，并使用与之严格匹配的 JSON Pointer：
return mapper.readerFor(FormattingConfigurationProperties.class)
.at("/formatting.template") // ← 关键：路径必须含点号，且加引号（JSON Pointer 规范）
.readValue(inputStream);⚠️ 注意事项：
- JSON Pointer 中若路径含特殊字符（如 ., /, ~），需按 RFC 6901 规范进行转义：. → ~1，~ → ~0。但 YAMLMapper 的 at() 方法对简单点号通常可直接支持（无需转义为 ~1），推荐优先尝试 /formatting.template；若失败，再试 /formatting~1template。
- @ConfigurationProperties + Spring Boot 场景下，.yml 文件由 Spring 自动转换为扁平化 PropertySource，此时 formatting.template.fields[0].name 可直接绑定，无需手动调用 YAMLMapper。本文讨论的是纯 Jackson YAMLMapper 手动解析场景。
- 若希望保持语义清晰且避免歧义，更推荐采用标准嵌套格式（即换行缩进）：
formatting:
template:
fields:
- name: birthdate
type: java.lang.String
subType: java.util.Date
lenght: 10对应代码不变（仍用 /formatting/template），语义明确、兼容性强、不易出错。
总结：YAML 中的点号不是语法符号，而是键名的一部分；Jackson 不做自动“点号拆分”，务必让 JSON Pointer 路径与 YAML 实际结构完全一致。理解这一差异，即可彻底规避 MismatchedInputException。
