计算机网络 / 系统课时
上传多个文件
上传多个文件
多文件上传的关键不是把文件拼成一个请求体,而是让 multipart/form-data 为每个文件建立独立 part,并用同一个 boundary 分隔。本课用 Flask 与 curl 完成一次可验证上传,同时说明同名字段、边界字符串和常见失败是怎样关联的。
学习目标
- 用同一个表单字段名提交多个文件,并在服务端按列表读取。
- 读懂
Content-Type中的boundary与请求体分隔线。 - 用 Flask 和 curl 验证文件名、数量与字节数是否正确。
多文件字段应该怎样组织
最常见的约定是重复同一个字段名,例如两个文件都使用 files。这样前端可以连续 append,后端则按列表读取;相比 file1、file2 这种固定位置命名,它更适合文件数量不确定的场景。
| 组织方式 | 请求中的字段 | Flask 读取方式 | 适用场景 |
|---|---|---|---|
| 同名字段重复 | files、files |
request.files.getlist("files") |
0~N 个附件,推荐 |
| 不同字段名 | front、back |
request.files["front"] 等 |
文件角色固定,例如证件正反面 |
如果浏览器使用 FormData,应对同一个键连续调用 append("files", file)。不要为了“表示数组”自行把字段改成 files[0]、files[1],除非服务端明确约定了这种命名。
用 Flask 和 curl 完成一次上传
下面用 Flask 接收同名 files 字段。示例只读取两个小文本文件来验证 multipart 结构;生产环境处理大文件时不要一次性 read() 到内存,应改为流式保存并设置大小限制。
from flask import Flask, jsonify, request
app = Flask(__name__)
app.json.sort_keys = False
@app.post("/upload")
def upload():
# getlist 会保留同名 files 字段中的多个文件。
uploaded = request.files.getlist("files")
# 本课只读取小文件来核对字节数,生产环境应改为流式保存。
result = [
{"name": item.filename, "bytes": len(item.read())}
for item in uploaded
]
return jsonify(result)
if __name__ == "__main__":
app.run(host="127.0.0.1", port=5000)把代码保存为 app.py,安装 Flask 并启动服务:
python -m pip install Flask
python app.py预期输出中会出现以下监听地址;Flask 版本不同,其他日志前缀可能略有差异:
* Running on http://127.0.0.1:5000另开终端创建两个文件并上传:
printf 'alpha\n' > a.txt
printf 'beta\n' > b.txt
curl -s -F 'files=@a.txt' -F 'files=@b.txt' http://127.0.0.1:5000/upload预期输出:
[{"name":"a.txt","bytes":6},{"name":"b.txt","bytes":5}]这里两个 -F 都使用 files,所以 Flask 能通过 getlist("files") 一次得到两个对象。若只写 request.files["files"],通常只能取到其中一个值,无法完整处理重复字段。
boundary 实际分隔了什么
multipart/form-data 的请求头会带一个 boundary 参数,请求体中的每个 part 都用同一串边界标记分开,最后一条边界再额外带两个连字符表示结束。下面是协议片段示例,不是手工发送请求时必须照抄的固定字符串。
Content-Type: multipart/form-data; boundary=----AnystackBoundary7MA4YWxk
------AnystackBoundary7MA4YWxk
Content-Disposition: form-data; name="files"; filename="a.txt"
Content-Type: text/plain
alpha
------AnystackBoundary7MA4YWxk
Content-Disposition: form-data; name="files"; filename="b.txt"
Content-Type: text/plain
beta
------AnystackBoundary7MA4YWxk--curl -F 和浏览器 FormData 都会自动生成 boundary,并保证请求头和请求体一致。尤其在浏览器里调用 fetch 时,不要手工设置 Content-Type: multipart/form-data;一旦漏掉自动生成的 boundary,服务端就无法正确切分各个 part。

常见失败与修正
| 现象 | 根因 | 修正 |
|---|---|---|
| 服务端得到 0 个文件 | 手工写了 Content-Type,但没有匹配的 boundary |
浏览器交给 FormData 自动设置;curl 使用 -F |
| 只收到 1 个文件 | 后端按单值读取同名字段 | Flask 改用 request.files.getlist("files") |
getlist("files") 为空 |
客户端字段实际叫 file 或 attachments |
让前后端字段名逐字一致 |
| 大文件时内存暴涨 | 示例式 read() 一次读完整文件 |
流式写磁盘或对象存储,并限制单文件与总请求大小 |
排查时先看请求头里的 boundary,再确认请求体每个 part 的 name,最后检查后端是否按列表读取。三处只要有一处约定不一致,多文件请求就可能退化成“只收到一个”或“完全收不到”。