Python Turbo-Flask表单提交响应中如何调用send_file()返回文件

Turbo-Flask 默认会拦截所有表单提交行为，期望后端返回 Turbo Stream 格式的 DOM 更新片段，直接返回 xlsx 二进制文件流时会因为不符合 Turbo 预期的响应格式失效，不需要重构原有业务逻辑，以下三种方案任选其一即可：

• 方案1：单表单绕开Turbo（零后端逻辑修改）
  直接在负责导出xlsx的表单标签上加data-turbo="false"属性，Turbo会完全跳过对这个表单提交的拦截，提交行为和未接入Turbo-Flask时完全一致，原有后端代码不需要做任何调整。
  模板代码示例：

  <form method="post" action="/your-export-path" data-turbo="false">
    <!-- 原有表单项、提交按钮完全保留即可 -->
  </form>
  

• 方案2：后端加响应头（不改前端模板）
  如果不想修改模板代码，就在原有返回xlsx的响应里补充对应响应头，明确告知Turbo当前响应需要触发浏览器默认下载行为，不要按Turbo Stream规则解析：

  from flask import send_file
  
  @app.route("/your-export-path", methods=["POST"])
  def handle_export():
      # 原有数据处理、xlsx生成逻辑完全不变
      generated_xlsx = 你的原有xlsx生成逻辑()
      response = send_file(
          generated_xlsx,
          mimetype="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
          as_attachment=True,
          download_name="导出结果.xlsx"
      )
      # 新增这行即可，告诉Turbo不要拦截该响应
      response.headers["Turbo-Frame"] = "_top"
      return response
  

• 方案3：303重定向实现（你提到的重定向方案完全可行）
  这个是Turbo官方推荐的表单提交后非Turbo响应处理方式，还能天然避免表单重复提交问题：

  1. 表单POST请求到后端后，先完成参数校验、数据预处理，把生成xlsx需要的参数临时存在session/缓存中，生成唯一导出标识
  2. 后端返回303 See Other状态码，重定向到对应GET类型的文件下载接口
  3. 下载接口读取临时存储的参数，生成xlsx后以文件流形式返回
     代码示例：

  from flask import redirect, url_for, session, send_file, abort
  import uuid
  
  @app.route("/your-export-path", methods=["POST"])
  def handle_export():
      # 接收表单参数
      form_data = request.form.to_dict()
      # 生成临时导出id，存储参数
      export_id = str(uuid.uuid4())
      session[f"export_{export_id}"] = form_data
      # 303重定向到下载接口
      return redirect(url_for("download_file", eid=export_id), code=303)
  
  @app.route("/download/<eid>")
  def download_file(eid):
      # 取出参数后清理临时存储
      params = session.pop(f"export_{eid}", None)
      if not params:
          abort(404)
      # 复用原有xlsx生成逻辑
      generated_xlsx = 你的xlsx生成逻辑(params)
      return send_file(generated_xlsx, as_attachment=True, download_name="导出结果.xlsx")
  

不需要为了适配Turbo重构原有的xlsx生成逻辑，Turbo只拦截期望返回DOM片段的异步请求，只要明确告知Turbo当前请求/响应需要走浏览器默认逻辑，原有代码可以直接复用。

内容的提问来源于stack exchange，提问作者Jed