You need to enable JavaScript to run this app. Python StreamingResponse不落地打包多CSV为Zip时提示文件损坏
优惠活动
大模型
产品
解决方案
定价
更多

Python StreamingResponse不落地打包多CSV为Zip时提示文件损坏

生成的Zip文件损坏的核心根因
  • 流读取时机错误:zipfile.ZipFile 的上下文管理器在退出时,才会完成整个Zip文件的封包收尾,包括写入中央目录结构、文件尾校验标识。当前代码将内存流指针重置、响应构造的逻辑全部写在 with 块内部,此时Zip文件还处于未完成写入的残缺状态,直接把不完整的字节流返回给前端,必然会被解压工具判定为文件损坏。这也是为什么Postman能正常拿到返回内容、不会报错,但系统解压工具会提示文件损坏的原因——Postman不对返回的二进制内容做格式校验,仅做字节流转发存储。
  • 编码转换错位:pandas.to_csv 写入 StringIO 文本流后,读取出的是Python字符串对象,直接传给 zf.writestr 会在库内部做隐式编码转换,容易出现字节偏移、内容错位,进一步破坏Zip结构。
  • 非标准MIME类型:使用的 application/x-zip-compressed 是Windows系统遗留的非标准MIME标识,部分解压工具会对非标准MIME的下载文件做错误校验,触发损坏提示。
无本地落地的可运行实现

修复逻辑全部围绕上述问题调整,全程仅在内存中完成文件打包,不写入服务器本地磁盘:

import io
import zipfile
from fastapi.responses import StreamingResponse

def prepare_zip(dataframes):
    # 初始化内存二进制流,承接全部打包内容
    outfile = io.BytesIO()
    # 上下文块内完成所有Zip写入、封包流程
    with zipfile.ZipFile(outfile, 'w', zipfile.ZIP_DEFLATED) as zf:
        for idx, df in enumerate(dataframes):
            # 用二进制流承接CSV内容,避免文本编码的隐式转换
            csv_stream = io.BytesIO()
            df.to_csv(csv_stream, index=False, encoding="utf-8")
            csv_stream.seek(0)
            # 直接将CSV二进制内容写入Zip包
            zf.writestr(f"{idx}.csv", csv_stream.getvalue())
    # 等Zip封包全部完成、流写入结束后,再将指针重置到流开头
    outfile.seek(0)
    response = StreamingResponse(
        outfile,
        media_type="application/zip"
    )
    response.headers["Content-Disposition"] = "attachment; filename=test.zip"
    return response

注意:原代码中的入参拼写 dafaframes 存在笔误,调整为 dataframes 即可,不影响核心逻辑运行。

内容的提问来源于stack exchange,提问作者Alon Golombek

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 05:36:01