计算机网络 / 系统课时
提交 JSON 数据
提交 JSON 数据
向 HTTP 接口发送对象时,关键不是“把一段 JSON 放进请求体”这么简单,而是同时保证序列化结果合法、Content-Type 正确,并能用响应验证服务器确实按 JSON 解析。下面用 curl 完成一条可复现的 POST 请求。
学习目标
- 正确设置
Content-Type: application/json并发送 JSON 请求体。 - 区分 JSON 文本、表单字段与普通字符串的传输差异。
- 通过回显响应检查请求头和结构化请求体是否被正确解析。
请求体与媒体类型要同时正确
JSON 请求通常包含两部分:请求头声明媒体类型,请求体放 UTF-8 JSON 文本。只有请求体看起来像 JSON、却写成 Content-Type: text/plain,服务器框架可能不会进入 JSON 解析器;反过来声明 JSON 却发送非法文本,也常得到 400 或 415。
一条最小请求可按下面的 HTTP 语义理解:方法是 POST,媒体类型是 application/json,主体是一个完整 JSON 对象。字段名和字符串必须使用双引号,不能把 JavaScript 对象字面量直接当成 JSON。

用 curl 发送一条 JSON POST 请求
下面示例使用公开回显端点 https://httpbin.org/post。--data-binary 会按给定内容发送请求体,-H 显式设置媒体类型,适合观察“头部声明”和“正文内容”这两个要点。
curl -sS https://httpbin.org/post \
-H 'Content-Type: application/json' \
--data-binary '{"name":"Ada","age":36,"active":true}'预期结果:响应 JSON 的关键字段应包含服务器解析出的 json 对象;响应还会带有其他回显字段,所以完整内容会比下面更多。
{
"json": {
"active": true,
"age": 36,
"name": "Ada"
}
}如果使用 curl 7.82.0 及以上,也可以用 --json '{"name":"Ada"}';它会自动添加 JSON 相关请求头。教学或排错时仍建议先显式写 Content-Type,这样更容易看清请求到底发了什么。
发送前先检查序列化结果
程序里的对象必须先序列化成 JSON 文本。浏览器或 Node.js 中应使用 JSON.stringify;不能把对象隐式转成字符串,否则常得到 [object Object],这不是合法 JSON。
const payload = { name: "Ada", tags: ["http", "json"], active: true };
const body = JSON.stringify(payload);
console.log(body);
console.log(JSON.parse(body).tags[1]);预期输出:
{"name":"Ada","tags":["http","json"],"active":true}
json实际发送时,还要把 body 作为请求体并配合 Content-Type: application/json。若服务端返回 400 Bad Request,先打印最终字符串再用 JSON 解析器验证;不要只检查源代码里的对象。
常见失败从状态码和回显定位
400 常表示请求体不是合法 JSON,例如尾随逗号、漏引号或截断;415 Unsupported Media Type 常表示接口要求 JSON,但请求没有使用它接受的媒体类型。具体状态码仍由服务端实现决定,应以接口文档和响应体为准。
排查时按固定顺序检查:先确认请求方法与 URL,再看 Content-Type,最后查看实际发送的原始请求体。若回显服务中的 json 为 null,而 data 中只是普通文本,通常说明正文没有被当作 JSON 解析。
发送 JSON 的判断标准很简单:线上抓包或回显中能同时看到正确的 Content-Type 与合法 JSON 正文,服务端又能得到预期字段和值,这条请求才算真正完成。