计算机网络 / 系统课时
上传单个文件
上传单个文件
单文件上传通常使用 multipart/form-data,因为它能在一次 HTTP 请求里同时携带二进制文件和普通文本字段。真正容易出错的是手工设置 Content-Type、漏掉 boundary,或把文件路径当成文本发送。下面用 curl 做一条可验证请求。
学习目标
- 理解 multipart 请求由 boundary、文件 part 和文本 part 组成。
- 使用
curl -F同时上传一个文件与一个文本字段。 - 通过回显结果确认文件内容和表单字段分别进入正确位置。
multipart/form-data 为什么适合上传文件
multipart/form-data 会把一个请求体切成多个 part,每个 part 都有自己的头部和内容。文件 part 通常带 Content-Disposition: form-data; name="file"; filename="hello.txt",文本字段则只需要字段名和值。
最重要的规则是:使用 curl -F、浏览器 FormData 等工具时,不要手工写整个 Content-Type。客户端会自动生成类似 boundary=------------------------abc... 的分隔符,并保证请求头里的 boundary 与请求体实际分隔线一致。

用 curl 上传一个文件和文本字段
先准备一个小文件,再用 -F 上传。@hello.txt 中的 @ 表示读取文件内容;如果写成 file=hello.txt,发送的只是字符串 hello.txt,不是文件本身。
printf 'Hello HTTP\n' > hello.txt
curl -sS https://httpbin.org/post \
-F 'description=demo file' \
-F 'file=@hello.txt;type=text/plain'预期结果:响应 JSON 的关键字段应同时出现 form.description 和 files.file。因为示例文件末尾包含换行,回显字符串中会显示 \n。
{
"files": {
"file": "Hello HTTP\n"
},
"form": {
"description": "demo file"
}
}type=text/plain 是文件 part 的媒体类型,不是整个请求的媒体类型。整个请求仍由 curl 自动生成 multipart/form-data; boundary=...,因此无需自己拼 boundary。
浏览器中用 FormData 交给运行时设置请求头
浏览器上传文件时,FormData 会生成 multipart 正文。不要给 fetch 手工设置 Content-Type,否则浏览器无法把自动生成的 boundary 补进你写死的请求头。
const input = document.querySelector("#file");
const data = new FormData();
data.append("description", "demo file");
data.append("file", input.files[0]);
const response = await fetch("/upload", {
method: "POST",
body: data
});
console.log(response.status);预期输出:当 /upload 正常接收并返回成功响应时,控制台应输出接口实际返回的成功状态码,例如:
200这里的 200 取决于示例接口实现;生产接口也可能按约定返回 201 或 204。验证重点不是固定某个成功码,而是确认网络面板中的请求头包含带 boundary 的 multipart/form-data,并且服务端确实收到了文件 part。
失败时先查字段名、文件内容和大小限制
服务端收不到文件时,先核对接口要求的字段名。接口若定义字段为 avatar,客户端却发 file,请求格式本身仍合法,但服务端绑定会失败。其次检查文件是否为空,以及反向代理或框架是否限制了请求体大小。
可用 curl -v 查看发送的请求头,但其中 boundary 是动态值,实际每次可能不同。若服务器返回 413 Payload Too Large,应检查服务器、网关和应用框架三层的上传大小限制;若返回 415,再核对文件 part 的媒体类型是否符合接口要求。
单文件上传是否正确,可以用三项验收:请求头中存在带 boundary 的 multipart/form-data,文件字段名与接口约定一致,服务端收到的文件大小和内容与本地文件一致。