把一段JSON复制到工具中,字段值没变,前两项却换了位置。如果它只是给人阅读,通常容易接受;如果这段文本要用于签名或摘要,顺序和空格的变化就可能让结果对不上。

本文在2026年11月17日用JSON格式化核对数字形态键、普通文本键和数组顺序,重点看工具实际输出,而不是假定格式化只会添加缩进。

先保存格式化之前的文本

输入以下对象,暂时不执行格式化:

{"10":"ten","2":"two","b":1,"a":2}

本次输入顺序是10、2、b、a。这里的 "10" 和 "2" 都是对象键,写在引号中;它们不是数组下标,也不是字段值。

尚未格式化的原文按10、2、b、a排列;这份文本应作为后续对照基线
尚未格式化的原文按10、2、b、a排列;这份文本应作为后续对照基线

如果业务把“收到的原始请求体”直接纳入签名,这份原文就有独立价值。先格式化再保存,只能保存处理后的另一份文本,无法重建发送者究竟用了多少空格、换行或哪种转义写法。

本次结果没有保持所有键的输入次序

执行校验格式化后,本次结果变成2、10、b、a。普通文本键b仍在a前面,所以这也不是把全部键按字母排序。

格式化结果中2出现在10之前,而b仍在a前;不能把这个输出概括成完整字典序排序
格式化结果中2出现在10之前,而b仍在a前;不能把这个输出概括成完整字典序排序

这个现象与JavaScript对象属性的枚举规则有关:符合数组索引形式的键,和其他字符串键使用不同的顺序处理。对象进入解析、重新序列化过程后,输出可以出现这种变化。JSON对象在数据模型上也不应依靠成员排列表达业务先后。

但“对象语义不依靠顺序”与“序列化后的字节相同”是两件事。下面这两段文本字段值相同,文本长度和字节排列却不同:

{"a":1,"b":2}
{ "b": 2, "a": 1 }

把任意一段送进文本哈希工具,都会按实际输入处理。不要因为两者解析成相近对象,就要求文本哈希自动相等;哈希工具不会替接口决定签名的规范化规则。

真正需要顺序时,用数据结构表达

第三组把顺序放入数组,用四个对象分别保存键名。格式化后的数组仍按10、2、b、a排列。

把先后关系放入数组后,本次格式化保留了数组元素次序;元素对象内部规则仍需单独考虑
把先后关系放入数组后,本次格式化保留了数组元素次序;元素对象内部规则仍需单独考虑

这不是把所有接口都改成数组的建议。字段本身没有先后含义时,对象很合适;若顺序代表执行步骤、展示列表或优先级,就应在接口模型里明确表达。不要寄希望于“服务端刚好按插入顺序返回”,再让多个语言的客户端据此执行关键逻辑。

数组也不能随意排序来“统一格式”。订单行、流程节点和时间序列通常对顺序敏感;即使字段名完全相同,交换两个元素也可能改变业务含义。

签名前先确认双方约定

对接签名时,先问清被签的是原始请求体字节,还是由字段按约定构造的规范形式。若采用原始字节,就保存发送前的那一份内容,编码、换行、空格和转义都不能在途中随手改写。

若协议要求规范化,应明确排序、数值序列化、字符串转义和允许的数据范围,并让两端使用同一约定。像JCS这样的规范化方案有完整规则,不能只用“按键名排序”四个字替代;更不能把本次工具输出直接当成所有签名协议的标准形式。

排查记录里最好保留原文、格式化结果、双方摘要和签名输入说明。工具适合帮助阅读与找字段;真正进入签名计算的那份数据,应按接口契约单独确认。