JSON最外层只能是大括号吗?数字和字符串也能通过,但接口未必接受
在JSON编辑框中输入 42,工具显示格式化成功;把一对大括号删掉以后,反而没有报错。这不代表校验失效。标准JSON允许最外层是一个JSON值,不要求每一份文本都以对象开始。
但“合法JSON”与“符合某个接口的数据结构”是两道检查。下面在JSON格式化工具中分别测试数字、字符串与对象,说明为什么它们都能通过,以及联调时还应该核对什么。
只输入一个数字,观察校验提示
清空编辑框,输入:
42
再点击“校验 / 格式化”。

这次没有自动补上大括号,也没有变成 {"value":42}。输出仍是 42,说明工具接受了最外层数值。它没有替用户创造字段名,更不能据此猜测你想提交一个 count 还是一个 status。
JSON的值可以是对象、数组、字符串、数字、布尔值或null。对象和数组是容器,但容器并不是每次都必须出现。很多入门样例都以对象展示,是因为实际接口经常需要多个字段,不是因为其他顶层值在语法上都非法。
如果接收方声明“请求体必须是对象”,那就是它的结构要求。把 42 交给只接受对象的接口,即使JSON语法正确,服务端仍可能返回参数类型错误。
字符串要带JSON自己的双引号
第二组输入:
"ready"

本次也显示成功,输出保留双引号。这里的双引号属于JSON源码,用来标记字符串的开始和结束。解析后得到的是字符串值 ready,引号不是值本身的一部分。
如果输入不带引号的 ready,它不属于JSON允许的字面量。不能因为一个接口常用“ready”表示状态,就把裸单词当作合法JSON。布尔值的 true、false 和空值 null 有专门的语法位置,其他普通词仍需成为带双引号的字符串。
也不要把HTTP响应头中的 Content-Type: application/json 当成结构检查。它声明的是媒体类型,不能保证响应正文一定是对象,更不会保证其中存在 status 字段。调用方仍需解析并核对实际类型。
接口需要多个字段时,再使用对象
第三组按一个虚构接口约定组织成对象:
{"status":"ready","count":42}

这份结果与前两组都合法,却包含了更多结构信息:接收方可以按成员名读取 status 与 count。工具的成功提示没有比较这三种结构是否符合相同接口,也不会告诉你缺少哪个必填字段。
例如,接口要求 count 必须是非负整数,传入 {"count":"42"} 时,字符串仍是合法JSON,却可能不符合接口的数值要求。字段名拼成 counts、漏掉 status、数组成员类型不符,也可能都通过普通语法校验。
语法检查适合先排除括号、逗号、引号等问题;字段存在性、类型、范围和业务组合条件,需要接口定义或相应的结构校验补上。不要反复点击格式化,期待它推导出服务端的参数规则。
联调时把两道检查留在记录里
拿到一份响应,先保存原始正文,确认能否按JSON解析,再记录最外层实际类型。若接口契约要求对象,就继续核对必填成员、可空字段和数组类型,而不是凭屏幕上有绿色提示就结束。
顶层字符串也不等于“里面一定还套着一份JSON”。只有接口明确约定字符串值本身装着JSON文本时,才考虑再解析一次。一般的 "ready" 解析一次已经得到目标字符串,再强行解析会把普通文本当语法。
选择数组还是对象,可以结合JSON对象与数组的结构说明核对使用场景。先确定接收方要怎样读取,再选择能够表达这份约定的JSON结构。