fastapi 如何响应文件下载

最新推荐文章于 2025-05-21 09:29:52 发布

原创最新推荐文章于 2025-05-21 09:29:52 发布 · 2.4k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#python #fastapi

Python开发学习笔记同时被 2 个专栏收录

60 篇文章

订阅专栏

FastAPI

1 篇文章

订阅专栏

这篇博客介绍了如何在FastAPI应用中实现文件下载功能。通过导入`FileResponse`类从`starlette.responses`模块，并确保已经安装了`aiofiles`依赖，可以设置路由返回指定路径的文件，同时指定下载时的文件名。示例代码展示了如何创建一个简单的FastAPI应用，当访问/file路由时，提供'demo.md'文件供用户下载。

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

fastapi 想要响应文件下载，需要从 starlette.responses 中导入 FileResponse

from starlette.responses import FileResponse

并在这之前还得安装 aiofiles 依赖包

pip install aiofiles

完整代码如下：
FileResponse 第一个参数为文件所在路径，第二个参数表示下载时文件所显示的名称

import uvicorn

from fastapi import FastAPI
from starlette.responses import FileResponse


app = FastAPI()


@app.get("/file")
def file():
    return FileResponse('./demo.md', filename='demo.md')


if __name__ == '__main__':
    uvicorn.run('main:app', port=5555, reload=True)