复制一份带 !!binary 的 YAML 配置到转换工具,内容明明很短,右侧 JSON 却是空的。这里先看错误是不是发生在类型标签上,别急着给 Base64 补等号或重新编码整个文件。

本次在YAML/JSON互转工具输入 payload: !!binary SGk=,点击“转换为 JSON”。当前入口返回 unknown scalar tag !<tag:yaml.org,2002:binary>,并标出第一行位置。这个样例没有得到 JSON 输出。

当前转换入口对binary标签提示unknown scalar tag
当前转换入口对binary标签提示unknown scalar tag

!!binary 是 YAML 类型库中描述二进制数据的标签,其标量内容使用 Base64 表示。类型库里有这种写法,和某个转换入口当前能够识别这种标签,是两件需要分别确认的事。本次实测只能确定这份输入在当前入口被拒绝。

把输入改为 payload: "SGk=" 后,转换得到带同名字符串字段的 JSON。本机另对 SGk= 做 Base64 解码,得到 Hi,字节值为七十二、一百零五。由此可以核对载荷本身;它并不能证明工具曾经成功加载了二进制标签。

本机真实记录:字符串成功结果与独立字节核对
本机真实记录:字符串成功结果与独立字节核对

如果接收接口允许用编码字符串保存二进制,适合明确约定字段结构,例如同时提供 encoding: "base64" 与 data: "SGk="。接收方按约定解码,再核对字节长度或摘要。直接删去标签而不通知接收方,会把有类型含义的数据改成普通字符串,后续程序未必知道该怎样读取。

需要原样迁移既有 YAML 时,应使用支持相应标签、并且与目标环境配置一致的解析器,先确认加载后的实际类型,再决定 JSON 表示。JSON 本身没有独立的二进制值类型,转换方案仍需双方约定。YAML转JSON的类型核对提供了常见对象、数组与标量的检查方法,可以先用小样例确认入口,再处理整份配置。