JSON语法通过却返回422,怎样区分解析失败与业务校验失败?
请求正文能被格式化工具展开,接口却返回422,这时继续删逗号、换引号通常没有帮助。JSON能够解析,只是内容检查的第一道条件;字段值能不能用于当前操作,还需要按业务约定判断。
2026年11月17日,本文用蜘蛛模拟抓取观察固定422状态,再在本机分别提交破损JSON、负数数量和正数数量。固定响应与本地实验是独立材料,没有连接真实订单系统。
固定422样例只能说明收到什么状态
公开地址 https://httpbingo.org/status/422 用于演示状态码。本次工具详情记录422及零跳转;它没有提交商品数量,也没有校验某个真实对象。因此,这张截图不能代替业务错误正文。

422说明服务理解请求内容的类型、语法也没有问题,但无法处理其中的指令。常见API会将字段约束失败映射到它,不过错误码和字段名仍是各应用自己的约定,不是所有服务都必须用相同JSON结构。
还应分清媒体类型与值校验。若声明的请求类型不被接受,可能在进入字段校验前就收到415;如果应用已经返回明确的422字段说明,优先检查它指出的约束,不要把错误统一归结为网络问题。
先让两个失败出现在不同层次
本地接口约定quantity必须是大于0的整数。第一轮故意漏掉JSON结尾,解析阶段返回400;第二轮提交完整的 {"quantity":-2},解析通过,字段值校验返回422。

这两个请求都没被业务接受,处理方式却不同。第一轮先修复语法;第二轮需要根据数量的实际含义修正输入,不能靠重新格式化把负数“修好”。格式化工具保留-2,恰好说明它完成的是语法处理,而非订单规则校验。
第三轮提交quantity为2,本例返回200与passed。这个通过条件仅限演示接口的一条数量约束,不包括库存、支付、权限或其他生产规则。

复现一条明确的字段约束
保存下面代码为 server.py,运行 python3 server.py。服务只监听本机8765,实验记录用了随机空闲端口;结束按Ctrl+C停止。
from http.server import BaseHTTPRequestHandler, HTTPServer
import json
class Demo(BaseHTTPRequestHandler):
def do_POST(self):
raw = self.rfile.read(int(self.headers.get('Content-Length', '0')))
try:
data = json.loads(raw)
value = data.get('quantity')
ok = type(value) is int and value > 0
code, result = (200, 'passed') if ok else (422, 'must_be_positive_integer')
except (ValueError, AttributeError):
code, result = 400, 'invalid_json_object'
body = json.dumps({'result': result}).encode()
self.send_response(code)
self.send_header('Content-Type', 'application/json')
self.send_header('Content-Length', str(len(body)))
self.end_headers(); self.wfile.write(body)
HTTPServer(('127.0.0.1', 8765), Demo).serve_forever()
另开终端,分别把下面命令的正文换成破损片段、-2和2作对照:
curl -i -H 'Content-Type: application/json' \
--data '{"quantity":-2}' 'http://127.0.0.1:8765/validate'
手动示例额外拒绝非对象输入和布尔值,避免把Python中的布尔值当整数;本次三组原始实验均使用对象和数字,没有测试全部JSON类型。
给校验错误留下可继续处理的信息
真实请求出现422时,保留目标对象、字段路径、错误码及对应输入类型。注意数字2与字符串“2”可能走不同规则;缺字段与字段值为null也可能不同。不要为了让请求通过而把所有值转成字符串,反而破坏接口契约。
如果接口返回一组字段错误,应先读清是否可以一次修正,再决定重试。无变化的请求持续返回相同约束错误,增加网络重试次数并不会改变字段值。
网站测速可补查入口响应与连接情况;字段是否符合业务要求,还要查看请求正文和错误详情。把“JSON可以解析”和“字段校验通过”分别记录,才能看清真正需要修正的是哪一层。