计算机网络 / 系统课时
区分 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 本身覆盖范围较广,因此“所有客户端输入错误都返回 400”并非一定违反 HTTP 语义。使用 422 的主要收益,是把“请求无法解析”和“请求已解析但内容无法执行”分开,让客户端采取不同修复方式。
用本地接口复现 400 与 422
下面的 Python 3 服务接收 POST /users。无法解析 JSON 时返回 400;JSON 可以解析,但 age 不是整数或小于 18 时返回 422;校验通过则返回 201。
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()预期输出:
listening on http://127.0.0.1:8001保持服务运行,在另一个终端分别发送“损坏 JSON”和“合法但年龄不通过”的请求。
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预期输出:
{"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 可以固定采用“媒体类型检查 → 报文与语法解析 → 字段和业务语义校验 → 资源状态检查”的顺序,使日志、监控和客户端分支能够从状态码快速定位失败层级。