FastAPI 学习之路（十八）表单与文件_fastapi formdata-优快云博客

本文链接：https://blog.youkuaiyun.com/myli_binbin/article/details/126544782

本文介绍如何使用FastAPI框架处理文件上传和表单数据。通过示例代码展示了单文件、多文件上传及结合表单数据的操作方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

我们首先要安装表单或者文件处理的依赖

pip install python-multipart

我们去实现下上传和form表单的组合使用

from fastapi import FastAPI, File, UploadFile, Form

app = FastAPI()


@app.post("/files")
async def create_file(
        file: bytes = File(...),
        one: UploadFile = File(...),
        token: str = Form(...)
):
    return {
        "filesize": len(file),
        "token": token,
        "oen_content_type": one.content_type
    }

我们去看下接口请求试试。

声明文件可以使用 bytes 或 UploadFile。可在一个路径操作中声明多个 File 与 Form 参数，但不能同时声明要接收 JSON 的 Body 字段。因为此时请求体的编码为 multipart/form-data

当然我们也可以上传多个文件，实现也很简单。代码如下

from fastapi import FastAPI, File, UploadFile, Form
from typing import List

app = FastAPI()


@app.post("/files")
async def create_file(
        file: bytes = File(...),
        one: List[UploadFile] = File(...),
        token: str = Form(...)
):
    return {
        "filesize": len(file),
        "token": token,
        "oen_content_type": [file.content_type for file in one]
    }

看下结果：