计算机网络 / 系统课时

区分 400 与 422

区分 400 与 422

400 和 422 都表示客户端请求存在问题,但表达层级不同:400 常用于请求本身无法正确解析或处理,422 更适合请求格式合法、内容类型也能理解,但其中的字段语义或业务指令无法执行。

学习目标

  • 能按“解析失败”和“语义校验失败”区分 400 与 422。
  • 能为 JSON API 设计可机器处理的错误响应。
  • 能识别应改用 409、415 等其他 4xx 状态码的边界场景。

先判断能不能解析再判断能不能处理

实用的判断顺序是先解析请求,再做字段和业务校验。JSON 缺括号、请求消息格式异常等问题在第一层就失败,通常返回 400;JSON 语法正确,但年龄不满足规则、枚举值非法或必填字段缺失,可以用 422 表示内容无法处理。

请求情况 推荐状态 原因
JSON 语法损坏 400 Bad Request 服务器无法可靠解析请求内容
JSON 合法,但 age 必须至少为 18 422 Unprocessable Content 内容可理解,但字段语义不满足处理规则
Content-Type 不受支持 415 Unsupported Media Type 问题是媒体类型,而不是字段语义
JSON 合法,但资源当前状态与操作冲突 常见为 409 Conflict 问题来自资源状态冲突

400 与 422 的判断流程

400 本身覆盖范围较广,因此“所有客户端输入错误都返回 400”并非一定违反 HTTP 语义。使用 422 的主要收益,是把“请求无法解析”和“请求已解析但内容无法执行”分开,让客户端采取不同修复方式。

用本地接口复现 400 与 422

下面的 Python 3 服务接收 POST /users。无法解析 JSON 时返回 400;JSON 可以解析,但 age 不是整数或小于 18 时返回 422;校验通过则返回 201。

python
import json
from http.server import BaseHTTPRequestHandler, HTTPServer

class Handler(BaseHTTPRequestHandler):
    def log_message(self, format, *args):
        pass

    def reply(self, status, payload):
        body = json.dumps(payload, separators=(',', ':')).encode()
        self.send_response(status)
        self.send_header('Content-Type', 'application/json')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)

    def do_POST(self):
        length = int(self.headers.get('Content-Length', '0'))
        raw = self.rfile.read(length)
        try:
            data = json.loads(raw)
        except json.JSONDecodeError:
            self.reply(400, {'code': 'invalid_json'})
            return

        age = data.get('age')
        if not isinstance(age, int) or age < 18:
            self.reply(422, {
                'code': 'validation_failed',
                'fields': {'age': 'must be an integer >= 18'}
            })
            return

        self.reply(201, {'id': 1, 'name': data.get('name')})

if __name__ == '__main__':
    print('listening on http://127.0.0.1:8001')
    HTTPServer(('127.0.0.1', 8001), Handler).serve_forever()

预期输出:

text
listening on http://127.0.0.1:8001

保持服务运行,在另一个终端分别发送“损坏 JSON”和“合法但年龄不通过”的请求。

bash
curl -s -o - -w '\nHTTP %{http_code}\n' -H 'Content-Type: application/json' -d '{"name":"Ada","age":}' http://127.0.0.1:8001/users
curl -s -o - -w '\nHTTP %{http_code}\n' -H 'Content-Type: application/json' -d '{"name":"Ada","age":16}' http://127.0.0.1:8001/users

预期输出:

text
{"code":"invalid_json"}
HTTP 400
{"code":"validation_failed","fields":{"age":"must be an integer >= 18"}}
HTTP 422

第一条请求连完整 JSON 对象都无法构造,因此在解析层返回 400;第二条请求已经成功得到对象,只是在应用规则中被拒绝,因此返回 422。

错误响应怎么设计

状态码只告诉客户端错误类别,响应体还应提供稳定的机器码。生产接口可以固定使用 code 表示错误类型,并在 422 这类字段校验失败时返回 fields,让前端可以把错误直接绑定到对应输入框。

错误做法是只返回 {"message":"参数错误"},客户端既不知道 JSON 是否损坏,也不知道哪个字段失败。更可用的设计是让 400 使用 invalid_json、invalid_request 等代码,让 422 使用 validation_failed 并附带字段级原因。

边界情况

不要把所有“业务失败”都塞进 422。例如用户提交的 JSON 完全合法,但订单已经从 pending 变成 paid,此时再次执行“取消待支付订单”更像资源当前状态发生冲突,409 往往比 422 更准确。

同样,客户端发送 Content-Type: text/plain,而接口只接受 JSON 时,应优先考虑 415。实际 API 可以固定采用“媒体类型检查 → 报文与语法解析 → 字段和业务语义校验 → 资源状态检查”的顺序,使日志、监控和客户端分支能够从状态码快速定位失败层级。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分 400 与 422

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通