0

0

FastAPI 实现文件上传与数据接收的综合教程

霞舞

霞舞

发布时间:2025-08-01 20:24:11

|

234人浏览过

|

来源于php中文网

原创

FastAPI 实现文件上传与数据接收的综合教程

本文详细介绍了如何在 FastAPI 框架中同时处理文件上传和接收额外数据。通过结合 UploadFile 类型和请求参数,开发者可以轻松构建支持文件上传和接收相关元数据的 API 接口。本文提供了代码示例,演示了如何接收上传的文件,并将其保存到服务器本地,同时接收其他字符串类型的参数,并介绍了注意事项。

在构建现代 web 应用程序时,经常需要处理文件上传和接收相关数据的场景。fastapi 提供了简洁而强大的方式来实现这一目标。本文将详细介绍如何使用 fastapi 的 uploadfile 类型来处理文件上传,并同时接收其他数据,例如字符串类型的 id 或描述信息。

使用 UploadFile 实现文件上传

FastAPI 提供了 UploadFile 类型,用于处理文件上传。要使用它,需要在路由函数中声明一个类型为 UploadFile 的参数。例如:

from fastapi import FastAPI, UploadFile

app = FastAPI()


@app.post("/upload")
async def upload_file(file: UploadFile):
    return {"filename": file.filename}

在这个例子中,/upload 路由接收一个名为 file 的 UploadFile 类型的参数。file 对象包含了上传文件的相关信息,例如文件名、内容类型等。

同时接收文件和额外数据

要同时接收文件和额外的数据,可以将 UploadFile 参数与其他类型的参数一起声明。例如:

from fastapi import FastAPI, UploadFile

app = FastAPI()


@app.post("/example")
async def create_upload_file(
    file: UploadFile, transaction_id: str, organization_id: str
):
    file_name = organization_id + transaction_id
    with open(file_name, "wb") as out_file:
        contents = await file.read()
        out_file.write(contents)
    return {"filename": file.filename, "transaction_id": transaction_id, "organization_id": organization_id}

在这个例子中,/example 路由接收一个 UploadFile 类型的 file 参数,以及两个字符串类型的参数 transaction_id 和 organization_id。

行业贸易网站管理系统 2007 Beta 1
行业贸易网站管理系统 2007 Beta 1

1.修正BUG站用资源问题,优化程序2.增加关键词搜索3.修改报价4.修正BUG 水印问题5.修改上传方式6.彻底整合论坛,实现一站通7.彻底解决群发垃圾信息问题。注册会员等发垃圾邮件7.彻底解决数据库安全9.修改交易方式.增加网站担保,和直接交易两中10.全站可选生成html.和单独新闻生成html(需要装组建)11. 网站有10中颜色选择适合不同的行业不同的颜色12.修改竞价格排名方式13.修

下载

代码解析

  • file: UploadFile: 声明一个 UploadFile 类型的参数,用于接收上传的文件。
  • transaction_id: str: 声明一个字符串类型的参数,用于接收交易 ID。
  • organization_id: str: 声明一个字符串类型的参数,用于接收组织 ID。
  • file_name = organization_id + transaction_id: 将组织 ID 和交易 ID 拼接成文件名。
  • with open(file_name, "wb") as out_file: 以二进制写入模式打开文件,用于保存上传的文件。
  • contents = await file.read(): 读取上传文件的内容。注意这里需要使用await关键字,因为file.read()是一个异步操作。
  • out_file.write(contents): 将文件内容写入到文件中。
  • return {"filename": file.filename, "transaction_id": transaction_id, "organization_id": organization_id}: 返回包含文件名、交易 ID 和组织 ID 的 JSON 响应。

注意事项

  • 确保在安装 FastAPI 时,同时安装了 python-multipart 库,它是处理文件上传的依赖项。可以使用 pip install python-multipart 命令安装。
  • 上传的文件默认存储在内存中。如果上传的文件较大,可能会导致内存溢出。为了避免这种情况,可以将文件保存到磁盘上。
  • 在生产环境中,应该对上传的文件进行安全检查,例如检查文件类型、大小等,以防止恶意文件上传。
  • 在保存文件时,应该使用唯一的文件名,以避免文件名冲突。

总结

本文介绍了如何在 FastAPI 中使用 UploadFile 类型来处理文件上传,并同时接收其他数据。通过结合 UploadFile 类型和请求参数,开发者可以轻松构建支持文件上传和接收相关元数据的 API 接口。希望本文能够帮助你更好地理解和使用 FastAPI。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

418

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

535

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

77

2025.09.10

Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

27

2025.12.22

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

339

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

414

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

761

2024.12.23

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

158

2026.01.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.3万人学习

Django 教程
Django 教程

共28课时 | 3.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号