在JSON编辑框中输入 42,工具显示格式化成功;把一对大括号删掉以后,反而没有报错。这不代表校验失效。标准JSON允许最外层是一个JSON值,不要求每一份文本都以对象开始。

但“合法JSON”与“符合某个接口的数据结构”是两道检查。下面在JSON格式化工具中分别测试数字、字符串与对象,说明为什么它们都能通过,以及联调时还应该核对什么。

只输入一个数字,观察校验提示

清空编辑框,输入:

42

再点击“校验 / 格式化”。

编辑框里只有数字42,当前工具仍显示格式化成功
编辑框里只有数字42,当前工具仍显示格式化成功

这次没有自动补上大括号,也没有变成 {"value":42}。输出仍是 42,说明工具接受了最外层数值。它没有替用户创造字段名,更不能据此猜测你想提交一个 count 还是一个 status。

JSON的值可以是对象、数组、字符串、数字、布尔值或null。对象和数组是容器,但容器并不是每次都必须出现。很多入门样例都以对象展示,是因为实际接口经常需要多个字段,不是因为其他顶层值在语法上都非法。

如果接收方声明“请求体必须是对象”,那就是它的结构要求。把 42 交给只接受对象的接口,即使JSON语法正确,服务端仍可能返回参数类型错误。

字符串要带JSON自己的双引号

第二组输入:

"ready"
带双引号的ready通过校验,输出没有变成status字段
带双引号的ready通过校验,输出没有变成status字段

本次也显示成功,输出保留双引号。这里的双引号属于JSON源码,用来标记字符串的开始和结束。解析后得到的是字符串值 ready,引号不是值本身的一部分。

如果输入不带引号的 ready,它不属于JSON允许的字面量。不能因为一个接口常用“ready”表示状态,就把裸单词当作合法JSON。布尔值的 true、false 和空值 null 有专门的语法位置,其他普通词仍需成为带双引号的字符串。

也不要把HTTP响应头中的 Content-Type: application/json 当成结构检查。它声明的是媒体类型,不能保证响应正文一定是对象,更不会保证其中存在 status 字段。调用方仍需解析并核对实际类型。

接口需要多个字段时,再使用对象

第三组按一个虚构接口约定组织成对象:

{"status":"ready","count":42}
第三组通过校验,status和count作为对象的两个成员清楚展开
第三组通过校验,status和count作为对象的两个成员清楚展开

这份结果与前两组都合法,却包含了更多结构信息:接收方可以按成员名读取 status 与 count。工具的成功提示没有比较这三种结构是否符合相同接口,也不会告诉你缺少哪个必填字段。

例如,接口要求 count 必须是非负整数,传入 {"count":"42"} 时,字符串仍是合法JSON,却可能不符合接口的数值要求。字段名拼成 counts、漏掉 status、数组成员类型不符,也可能都通过普通语法校验。

语法检查适合先排除括号、逗号、引号等问题;字段存在性、类型、范围和业务组合条件,需要接口定义或相应的结构校验补上。不要反复点击格式化,期待它推导出服务端的参数规则。

联调时把两道检查留在记录里

拿到一份响应,先保存原始正文,确认能否按JSON解析,再记录最外层实际类型。若接口契约要求对象,就继续核对必填成员、可空字段和数组类型,而不是凭屏幕上有绿色提示就结束。

顶层字符串也不等于“里面一定还套着一份JSON”。只有接口明确约定字符串值本身装着JSON文本时,才考虑再解析一次。一般的 "ready" 解析一次已经得到目标字符串,再强行解析会把普通文本当语法。

选择数组还是对象,可以结合JSON对象与数组的结构说明核对使用场景。先确定接收方要怎样读取,再选择能够表达这份约定的JSON结构。