计算机网络 / 系统课时

理解 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 是什么”,而不是“希望对方返回什么”。

text
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。

python
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()

启动服务:

bash
python content_type_demo.py

预期结果:进程持续监听 127.0.0.1:8081,收到请求后会输出带动态时间的访问日志。

text
127.0.0.1 - - [<TIME>] "POST / HTTP/1.1" 200 -

另开终端发送 JSON 请求:

bash
curl -s http://127.0.0.1:8081/ -H "Content-Type: application/json" --data '{"name":"Alice","age":30}'

预期输出:

json
{"name": "Alice", "age": 30}

如果把请求头改成 Content-Type: text/plain,即使正文看起来仍然像 JSON,这个示例也会返回 HTTP 415。也就是说,媒体类型声明和实际内容必须一起检查,不能只凭正文长相猜测解析方式。

charset 说明文本怎样还原

charset 是媒体类型参数,例如 text/plain; charset=utf-8。它用于告诉接收方怎样把正文中的字节还原为字符。对于纯文本或 HTML,明确采用 UTF-8 能避免双方使用不同默认编码时出现乱码。

text
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 请求完全可能同时包含下面两个头,它们并不重复。

text
Content-Type: application/json
Accept: application/json

服务器不支持请求体媒体类型时,常见响应是 415 Unsupported Media Type;服务器无法提供客户端声明可接受的响应类型时,可能返回 406 Not Acceptable。具体接口是否返回这些状态码仍由服务端实现决定。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Content-Type

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

登录哪都通