YAMLMapper 解析带点号（.）的嵌套键名时的正确用法_网络技术

YAMLMapper 解析带点号（.）的嵌套键名时的正确用法

发布时间 - 2025-12-29 00:00:00 点击率：次

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: 10

YAML 解析器（包括 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。

# java # js # json # app # stream # spring # spring boot # 字符串 # pointer # map # 对象 # input # 是一个 # 分隔符 # 可直接 # 键名 # 不将 # 的是 # 这一 # 就会 # 不存在 # 不做

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：详解在swift中实现NSCoding的自动归档和解档

下一篇：Linux磁盘空间如何排查_标准流程剖析适用于全部场景【指导

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：详解在swift中实现NSCoding的自动归档和解档

下一篇：Linux磁盘空间如何排查_标准流程剖析适用于全部场景【指导