JSON数字为什么不能有前导零?编号与数值应该怎样分开保存
门店编号写成00123,是为了固定五位;数量写成123,是为了参加计算。两者在表格里可能只差一个显示格式,到了JSON接口里,却应该先决定它究竟是编号文本还是数字值。
2026年11月17日,本文在JSON格式化中分别测试不带引号的00123、带引号的编号,以及正常数字123。三个输入只有一个字段,便于把报错原因限定在值的写法上。
直接写00123,本次校验没有通过
第一组输入如下:
{"id":00123}
本次工具提示第一行解析错误,位置靠近连续的数字。编辑区即使仍然能显示缩进,也不能代替错误条的判断;文本看上去整齐,不等于它已经是有效JSON。

JSON数字的整数部分不接受这种前导零写法。单独的0可以出现,0后面也可以接小数点形成0.5,但不能把00123当作普通十进制数字字面量。也不要套用某些语言的旧式八进制规则,试图把它解释成另一个进制。
这一步先解决语法问题。即使去掉零以后通过,仍然要检查有没有破坏编号的固定宽度;“让解析器不报错”并不是唯一目标。
编号要保留原样,就明确写成字符串
第二组给00123加上JSON双引号:
{"id":"00123"}
本次校验通过,输出保留了五位编号。这时字段类型已经是字符串,开头的两个0属于内容。

适合这样保存的值包括固定宽度编号、订单号和可能包含字母的标识。它们通常用于比对、查询或展示,而不是求和。后续客户端也要按字符串接收,不然反序列化之后又转成数字,前导零仍会丢掉。
从表格导出时,应在导出前确认单元格底层是文本还是数字加显示格式。界面显示00123,不保证文件实际保存的值也是五个字符;如果原值已经只剩123,JSON工具没有证据帮你恢复原本应有几位。
数量确实是123,就使用数字
第三组改成 {"id":123},本次同样通过。它与字符串版本都符合语法,但含义不同:一个是数值123,一个是五字符文本00123。

如果业务真正要表达数量、金额或计数,应按接口规范使用相应数值类型,并另外约定小数精度。不要为了修复一次前导零错误,就把所有数字统一加引号;服务端可能因此拒绝请求,也可能进行隐式类型转换,造成新的差异。
同理,前导零编号也不应先转数字、再随意补零。只有协议明确要求固定长度时,补齐规则才有依据;不同系统的门店号、地区码与流水号,未必采用同一种长度。
转换之前先核对来源类型
如果材料来自YAML,可以使用YAML/JSON互转观察转换后的引号和类型。有些输入写法会被解析器识别成数字,再输出成无前导零的形式。判断保留情况时,应看真实输出,不能只看原材料里有没有0。
检查接口时,记录原始字段、预期类型、实际发送正文和服务端错误。先用最小样例确认字符串版本是否符合该字段的契约,再回到完整业务对象。这样既能处理语法,也能避免把修正格式变成修改编号。
对于已经丢失宽度的历史数据,应回查原始文件或编号规则。解析工具可以告诉你当前文本是否成立,却不能从123推断它原本是00123、0123还是123。