计算机网络 / 系统课时

上传多个文件

上传多个文件

多文件上传的关键不是把文件拼成一个请求体,而是让 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() 到内存,应改为流式保存并设置大小限制。

python
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 并启动服务:

bash
python -m pip install Flask
python app.py

预期输出中会出现以下监听地址;Flask 版本不同,其他日志前缀可能略有差异:

text
* Running on http://127.0.0.1:5000

另开终端创建两个文件并上传:

bash
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

预期输出:

json
[{"name":"a.txt","bytes":6},{"name":"b.txt","bytes":5}]

这里两个 -F 都使用 files,所以 Flask 能通过 getlist("files") 一次得到两个对象。若只写 request.files["files"],通常只能取到其中一个值,无法完整处理重复字段。

boundary 实际分隔了什么

multipart/form-data 的请求头会带一个 boundary 参数,请求体中的每个 part 都用同一串边界标记分开,最后一条边界再额外带两个连字符表示结束。下面是协议片段示例,不是手工发送请求时必须照抄的固定字符串。

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

multipart 多文件上传中 boundary 分隔同名 files 字段的关系

常见失败与修正

现象 根因 修正
服务端得到 0 个文件 手工写了 Content-Type,但没有匹配的 boundary 浏览器交给 FormData 自动设置;curl 使用 -F
只收到 1 个文件 后端按单值读取同名字段 Flask 改用 request.files.getlist("files")
getlist("files") 为空 客户端字段实际叫 file 或 attachments 让前后端字段名逐字一致
大文件时内存暴涨 示例式 read() 一次读完整文件 流式写磁盘或对象存储,并限制单文件与总请求大小

排查时先看请求头里的 boundary,再确认请求体每个 part 的 name,最后检查后端是否按列表读取。三处只要有一处约定不一致,多文件请求就可能退化成“只收到一个”或“完全收不到”。

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

目录与阅读设置

阅读设置

17

记录一个想法

上传多个文件

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

登录哪都通