HTTP Content-Type介绍（x-www-form-urlencoded、multipart/form-data、text/plain、text/html、octet-stream）内容类型
文章目录
- 一文搞懂 HTTP Content-Type
- 一、什么是 Content-Type？
- 二、为什么 Content-Type 很重要？
- 三、常见 Content-Type 类型
- 1. application/json（最常用）
- 2. application/x-www-form-urlencoded
- 3. multipart/form-data
- 4. text/plain
- 5. text/html
- 6. application/xml
- 7. application/octet-stream
- 四、请求 vs 响应中的 Content-Type
- 1. 请求中的 Content-Type
- 2. 响应中的 Content-Type
- 五、Content-Type vs Accept
- 六、常见坑点
- 1. 忘记设置 Content-Type
- 2. JSON 写成 form
- 3. 字符编码问题
- 4. 文件上传必须用 multipart/form-data
- 七、实际开发建议
- 1. 统一使用 JSON（推荐）
- 2. 接口文档必须写清楚
- 3. 后端要做容错处理
- 八、总结
一文搞懂 HTTP Content-Type
在日常开发中，我们几乎每天都会接触 HTTP 协议，而Content-Type是其中最基础却又最容易被忽视的一个字段。很多接口问题、乱码问题、跨语言调用问题，其实都和它有关。
这篇文章带你彻底搞懂Content-Type的作用、常见类型，以及实际开发中的注意事项。
一、什么是 Content-Type？
Content-Type是 HTTP 头（Header）中的一个字段，用来指明请求或响应体的数据类型（媒体类型，MIME type）。
简单来说，它回答的是一个问题：
👉 “这段数据是什么格式？”
例如：
Content-Type: application/json表示 Body 中的数据是 JSON 格式。
二、为什么 Content-Type 很重要？
如果没有Content-Type，接收方就无法正确解析数据。
举个例子：
- 你发送的是 JSON，但没写
Content-Type - 服务端可能按表单格式解析
- 结果：解析失败 / 参数为空 / 报错
👉 本质上就是“协议不一致”。
三、常见 Content-Type 类型
1. application/json（最常用）
Content-Type: application/json用于传输 JSON 数据：
{"name":"Tom","age":20}📌 使用场景：
- RESTful API
- 微服务通信
- 前后端分离
2. application/x-www-form-urlencoded
Content-Type: application/x-www-form-urlencoded数据格式类似 URL 参数：
name=Tom&age=20📌 使用场景：
- HTML 表单默认提交方式
- 传统 Web 应用
3. multipart/form-data
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary用于上传文件：
------boundary Content-Disposition: form-data; name="file"; filename="a.txt" Content-Type: text/plain (file content)📌 使用场景：
- 文件上传
- 图片上传
4. text/plain
Content-Type: text/plain表示纯文本：
Hello World📌 使用场景：
- 简单文本接口
- 调试接口
5. text/html
Content-Type: text/html表示 HTML 页面：
<h1>Hello</h1>📌 使用场景：
- 浏览器页面响应
6. application/xml
Content-Type: application/xml用于 XML 数据：
<user><name>Tom</name></user>📌 使用场景：
- 老系统
- SOAP 服务
7. application/octet-stream
Content-Type: application/octet-stream表示二进制数据（通用类型）：
📌 使用场景：
- 文件下载
- 不确定类型的数据
四、请求 vs 响应中的 Content-Type
1. 请求中的 Content-Type
👉 告诉服务器：我发送的数据是什么格式
例如：
POST /api/user Content-Type: application/json2. 响应中的 Content-Type
👉 告诉客户端：你收到的数据是什么格式
例如：
HTTP/1.1 200 OK Content-Type: application/json五、Content-Type vs Accept
很多人会混淆这两个字段。
| Header | 作用 |
|---|---|
| Content-Type | 我发送的是什么 |
| Accept | 我希望接收什么 |
示例：
Accept: application/json表示客户端希望服务器返回 JSON。
六、常见坑点
1. 忘记设置 Content-Type
表现：
- 后端收不到参数
- JSON 解析失败
2. JSON 写成 form
错误：
Content-Type: application/x-www-form-urlencoded但 Body 是 JSON：
{"name":"Tom"}👉 一定会解析失败
3. 字符编码问题
Content-Type: text/html; charset=UTF-8如果不指定 charset，可能导致乱码。
4. 文件上传必须用 multipart/form-data
很多人误用：
application/json👉 文件上传一定要用：
multipart/form-data七、实际开发建议
1. 统一使用 JSON（推荐）
现代系统建议统一：
Content-Type: application/json优点：
- 可读性强
- 跨语言支持好
- 与 RESTful 风格一致
2. 接口文档必须写清楚
比如：
Content-Type:application/json否则调用方容易踩坑。
3. 后端要做容错处理
例如：
- 自动识别 JSON / form
- 给出清晰错误提示
八、总结
一句话总结：
Content-Type 决定了数据如何被解析。
记住三点就够了：
- 它定义数据格式
- 请求和响应都可以使用
- 错了就会解析失败