如何使用 FastAPI 从内存缓冲区返回 PDF 文件?

2025-03-26 09:09:00
admin
原创
15
摘要:问题描述:我想从 s3 获取一个 PDF 文件,然后从 FastAPI 后端将其返回到前端。这是我的代码:@router.post("/pdf_document") def get_pdf(document : PDFRequest) : s3 = boto3.client('s3...

问题描述:

我想从 s3 获取一个 PDF 文件,然后从 FastAPI 后端将其返回到前端。

这是我的代码:

@router.post("/pdf_document")
def get_pdf(document : PDFRequest) :
    s3 = boto3.client('s3')
    file=document.name
    f=io.BytesIO()
    s3.download_fileobj('adm2yearsdatapdf', file,f)
    return StreamingResponse(f, media_type="application/pdf")

该API返回200状态码,但是不返回PDF文件作为响应。


解决方案 1:

由于整个文件数据已加载到内存中,因此没有实际理由使用StreamingResponse。您应该改用Response,通过传递文件字节(用于BytesIO.getvalue()获取包含缓冲区全部内容的字节)、定义media_type以及设置标题Content-Disposition,以便可以在浏览器中查看 PDF 文件或将其下载到用户的设备。有关更多详细信息和示例,请查看此答案以及此和此。相关答案也可以在这里找到。

此外,由于在调用方法buffer时会丢弃close(),因此您也可以使用 FastAPI/Starlette在返回响应后BackgroundTasks关闭buffer,以释放内存。或者,您可以使用获取字节pdf_bytes = buffer.getvalue(),然后使用关闭缓冲区buffer.close(),最后,return Response(pdf_bytes, headers=...

例子

from fastapi import Response, BackgroundTasks

@app.get("/pdf")
def get_pdf(background_tasks: BackgroundTasks):
    buffer = io.BytesIO()  # BytesIO stream containing the pdf data
    # ...
    background_tasks.add_task(buffer.close)
    headers = {'Content-Disposition': 'inline; filename="out.pdf"'}
    return Response(buffer.getvalue(), headers=headers, media_type='application/pdf')

要下载 PDF 文件而不是在浏览器中查看,请使用:

headers = {'Content-Disposition': 'attachment; filename="out.pdf"'}

解决方案 2:

我的缓冲区和将 pdf 作为可下载链接发送的代码在http://127.0.0.1:8000/docs
添加到标题字典“content-type”:“application/octet-stream”

async def convert_img_to_webp(img):
    image_io = BytesIO()
    image = Image.open(img)
    image.convert("RGB")
    image.save(image_io,"PDF")
    image_io.seek(0)
    # BackgroundTasks.add_task(image_io.close)
    return image_io


@router.post("/image/")
async def upload_file(file:UploadFile):
    if file:
        data = await convert_img_to_webp(file.file)
        headers = {'Content-Disposition': 'inline; filename="sample.pdf"',"content-type": "application/octet-stream"}
        return StreamingResponse(data,media_type='application/pdf',headers=headers)
    else:
        print("file not found")
        return
相关推荐
  政府信创国产化的10大政策解读一、信创国产化的背景与意义信创国产化,即信息技术应用创新国产化,是当前中国信息技术领域的一个重要发展方向。其核心在于通过自主研发和创新,实现信息技术应用的自主可控,减少对外部技术的依赖,并规避潜在的技术制裁和风险。随着全球信息技术竞争的加剧,以及某些国家对中国在科技领域的打压,信创国产化显...
工程项目管理   2079  
  为什么项目管理通常仍然耗时且低效?您是否还在反复更新电子表格、淹没在便利贴中并参加每周更新会议?这确实是耗费时间和精力。借助软件工具的帮助,您可以一目了然地全面了解您的项目。如今,国内外有足够多优秀的项目管理软件可以帮助您掌控每个项目。什么是项目管理软件?项目管理软件是广泛行业用于项目规划、资源分配和调度的软件。它使项...
项目管理软件   1459  
  建筑行业正处于数字化转型的关键时期,建筑产品生命周期管理(PLM)系统的实施对于提升项目效率、质量和协同性至关重要。特别是在 2025 年,基于建筑信息模型(BIM)的项目进度优化工具成为众多建筑企业关注的焦点。这些工具不仅能够整合项目全生命周期的数据,还能通过精准的分析和模拟,为项目进度管理提供强大支持。BIM 与建...
plm是什么软件   0  
  PLM系统开发的重要性与现状PLM(产品生命周期管理)系统在现代企业的产品研发、生产与管理过程中扮演着至关重要的角色。它贯穿产品从概念设计到退役的整个生命周期,整合了产品数据、流程以及人员等多方面的资源,极大地提高了企业的协同效率和创新能力。通过PLM系统,企业能够实现产品信息的集中管理与共享,不同部门之间可以实时获取...
国产plm软件   0  
  PLM(产品生命周期管理)系统在企业产品研发与管理过程中扮演着至关重要的角色。随着市场竞争的加剧和技术的飞速发展,企业对PLM系统的迭代周期优化需求日益迫切。2025年敏捷认证对项目管理提出了新的要求,其中燃尽图作为一种强大的可视化工具,在PLM系统迭代周期优化中有着广泛且重要的应用。深入探讨这些应用,对于提升企业的项...
plm系统主要干什么的   0  
热门文章
项目管理软件有哪些?
云禅道AD
禅道项目管理软件

云端的项目管理软件

尊享禅道项目软件收费版功能

无需维护,随时随地协同办公

内置subversion和git源码管理

每天备份,随时转为私有部署

免费试用