门店编号写成00123,是为了固定五位;数量写成123,是为了参加计算。两者在表格里可能只差一个显示格式,到了JSON接口里,却应该先决定它究竟是编号文本还是数字值。

2026年11月17日,本文在JSON格式化中分别测试不带引号的00123、带引号的编号,以及正常数字123。三个输入只有一个字段,便于把报错原因限定在值的写法上。

直接写00123,本次校验没有通过

第一组输入如下:

{"id":00123}

本次工具提示第一行解析错误,位置靠近连续的数字。编辑区即使仍然能显示缩进,也不能代替错误条的判断;文本看上去整齐,不等于它已经是有效JSON。

id写成无引号00123时本次校验报错;应以错误提示判断,而不是把缩进后的外观当成通过
id写成无引号00123时本次校验报错;应以错误提示判断,而不是把缩进后的外观当成通过

JSON数字的整数部分不接受这种前导零写法。单独的0可以出现,0后面也可以接小数点形成0.5,但不能把00123当作普通十进制数字字面量。也不要套用某些语言的旧式八进制规则,试图把它解释成另一个进制。

这一步先解决语法问题。即使去掉零以后通过,仍然要检查有没有破坏编号的固定宽度;“让解析器不报错”并不是唯一目标。

编号要保留原样,就明确写成字符串

第二组给00123加上JSON双引号:

{"id":"00123"}

本次校验通过,输出保留了五位编号。这时字段类型已经是字符串,开头的两个0属于内容。

把00123放进双引号后,校验通过且前导零保留;字段类型是字符串
把00123放进双引号后,校验通过且前导零保留;字段类型是字符串

适合这样保存的值包括固定宽度编号、订单号和可能包含字母的标识。它们通常用于比对、查询或展示,而不是求和。后续客户端也要按字符串接收,不然反序列化之后又转成数字,前导零仍会丢掉。

从表格导出时,应在导出前确认单元格底层是文本还是数字加显示格式。界面显示00123,不保证文件实际保存的值也是五个字符;如果原值已经只剩123,JSON工具没有证据帮你恢复原本应有几位。

数量确实是123,就使用数字

第三组改成 {"id":123},本次同样通过。它与字符串版本都符合语法,但含义不同:一个是数值123,一个是五字符文本00123。

数字123可以通过校验,但不会包含固定宽度信息;不能用它替代所有编号字符串
数字123可以通过校验,但不会包含固定宽度信息;不能用它替代所有编号字符串

如果业务真正要表达数量、金额或计数,应按接口规范使用相应数值类型,并另外约定小数精度。不要为了修复一次前导零错误,就把所有数字统一加引号;服务端可能因此拒绝请求,也可能进行隐式类型转换,造成新的差异。

同理,前导零编号也不应先转数字、再随意补零。只有协议明确要求固定长度时,补齐规则才有依据;不同系统的门店号、地区码与流水号,未必采用同一种长度。

转换之前先核对来源类型

如果材料来自YAML,可以使用YAML/JSON互转观察转换后的引号和类型。有些输入写法会被解析器识别成数字,再输出成无前导零的形式。判断保留情况时,应看真实输出,不能只看原材料里有没有0。

检查接口时,记录原始字段、预期类型、实际发送正文和服务端错误。先用最小样例确认字符串版本是否符合该字段的契约,再回到完整业务对象。这样既能处理语法,也能避免把修正格式变成修改编号。

对于已经丢失宽度的历史数据,应回查原始文件或编号规则。解析工具可以告诉你当前文本是否成立,却不能从123推断它原本是00123、0123还是123。