计算机网络 / 系统课时
理解 Content-Type
理解 Content-Type
Content-Type 描述当前 HTTP 消息体采用什么媒体类型,接收方据此决定按 JSON、文本、HTML、图片还是其他格式处理数据;文本内容还可能带 charset 参数。读完本课,你可以正确设置常见媒体类型,并判断正文内容与类型声明是否匹配。
学习目标
- 区分
Content-Type描述的内容与Accept表达的期望。 - 正确使用
application/json、text/plain等常见媒体类型。 - 判断字符编码参数是否与实际消息体一致。
Content-Type 描述当前消息体
请求和响应都可以携带 Content-Type。客户端提交 JSON 时通常使用 application/json;服务器返回 HTML 时常见 text/html; charset=utf-8。它回答的是“当前这段 body 是什么”,而不是“希望对方返回什么”。
POST /users HTTP/1.1
Host: api.example.test
Content-Type: application/json
Content-Length: 16
{"name":"Alice"}媒体类型由主类型和子类型组成。API 中常见 application/json,普通文本常见 text/plain,网页常见 text/html,PNG 图片使用 image/png。如果响应本身没有消息体,例如典型的 204 No Content,就没有必要为了形式强行声明正文类型。
用本地服务验证 JSON 类型
下面程序只接受 application/json。它先取出分号前的媒体类型,再解析 JSON;收到其他媒体类型时返回 415 Unsupported Media Type,JSON 本身损坏时返回 400 Bad Request。
import json
from http.server import BaseHTTPRequestHandler, HTTPServer
class Handler(BaseHTTPRequestHandler):
def do_POST(self):
content_type = self.headers.get("Content-Type", "")
media_type = content_type.split(";", 1)[0].strip().lower()
if media_type != "application/json":
self.send_error(415, "Unsupported Media Type")
return
length = int(self.headers.get("Content-Length", "0"))
raw = self.rfile.read(length)
try:
data = json.loads(raw.decode("utf-8"))
except (UnicodeDecodeError, json.JSONDecodeError):
self.send_error(400, "Bad Request")
return
body = json.dumps(data).encode("utf-8")
self.send_response(200)
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", 8081), Handler).serve_forever()启动服务:
python content_type_demo.py预期结果:进程持续监听 127.0.0.1:8081,收到请求后会输出带动态时间的访问日志。
127.0.0.1 - - [<TIME>] "POST / HTTP/1.1" 200 -另开终端发送 JSON 请求:
curl -s http://127.0.0.1:8081/ -H "Content-Type: application/json" --data '{"name":"Alice","age":30}'预期输出:
{"name": "Alice", "age": 30}如果把请求头改成 Content-Type: text/plain,即使正文看起来仍然像 JSON,这个示例也会返回 HTTP 415。也就是说,媒体类型声明和实际内容必须一起检查,不能只凭正文长相猜测解析方式。
charset 说明文本怎样还原
charset 是媒体类型参数,例如 text/plain; charset=utf-8。它用于告诉接收方怎样把正文中的字节还原为字符。对于纯文本或 HTML,明确采用 UTF-8 能避免双方使用不同默认编码时出现乱码。
Content-Type: text/plain; charset=utf-8对于 application/json,现代 JSON 交换通常直接使用 UTF-8,通常写 Content-Type: application/json 即可。更重要的是实际发送的字节必须是正确的 UTF-8 数据;给图片、压缩包等二进制媒体类型添加 charset 没有意义。
不要把 Content-Type 和 Accept 混在一起
两者方向不同:Content-Type 说明本次发送的消息体是什么,Accept 表示客户端希望响应采用什么媒体类型。一个 JSON API 请求完全可能同时包含下面两个头,它们并不重复。
Content-Type: application/json
Accept: application/json服务器不支持请求体媒体类型时,常见响应是 415 Unsupported Media Type;服务器无法提供客户端声明可接受的响应类型时,可能返回 406 Not Acceptable。具体接口是否返回这些状态码仍由服务端实现决定。