Flask send_file下载文件异常 实际下载html而非指定txt文件

基于提供的最小可复现示例，点击表单的「Generate Report」按钮提交POST请求后，预期下载名为test-downloaded-report.txt的纯文本文件，实际下载到本地的是reports2.html文件。同时需要实现「触发文件下载的同时重置表单/跳转页面」的交互效果。

最小可复现代码 #

HTML模板（report/reports2.html） #

<block body>
  <h2> Test Report </h2>
  <form method="post">
    <input type="submit" value="Generate Report">
  </form>
</block body>

Flask蓝图逻辑 #

@bp.route('/reports2', methods=('GET', 'POST'))
@login_required
def reports2():
    if request.method == 'POST':
        from io import BytesIO
        byte_obj = BytesIO()
        byte_obj.write(b'Hello, I am a test file')
        return send_file(byte_obj, as_attachment=True, download_name='test-downloaded-report.txt', mimetype='text/plain')                                                                                                                                                                                   
    return render_template('report/reports2.html')

1. 文件下载不符合预期的核心原因是内存流指针位置错误：调用byte_obj.write()向BytesIO对象写入内容后，文件指针默认停在已写入内容的末尾，send_file从指针当前位置开始读取流内容，读到的是空数据。部分浏览器接收到空的附件响应时，会自动回退下载当前请求路径对应的GET响应内容，也就是路由渲染的reports2.html文件。
2. 「同个请求同时返回下载+重定向」无法实现是HTTP协议本身的限制：单个HTTP请求只能对应一个响应，返回文件流的响应和返回重定向状态码的响应无法在同一次请求中同时下发。

1. 修复文件下载异常 #

在写入内存流完成后、调用send_file之前，加一行byte_obj.seek(0)将流指针重置到内容起始位置，保证send_file能读到完整的文件内容。
修复后的POST分支代码：

if request.method == 'POST':
    from io import BytesIO
    byte_obj = BytesIO()
    byte_obj.write(b'Hello, I am a test file')
    byte_obj.seek(0)  # 重置流指针到起始位置
    return send_file(byte_obj, as_attachment=True, download_name='test-downloaded-report.txt', mimetype='text/plain')

2. 实现「下载文件+页面重置/跳转」效果 #

两种无兼容问题的实现方式可选：

• 前端异步处理：给表单绑定提交事件，用户点击提交、POST请求发出后，延迟几百毫秒执行表单重置或页面跳转逻辑。浏览器会独立处理服务端返回的下载响应，前端跳转/重置操作不会打断下载流程。参考代码：

  <block body>
    <h2> Test Report </h2>
    <form method="post" id="reportForm">
      <input type="submit" value="Generate Report">
    </form>
    <script>
      const reportForm = document.getElementById('reportForm')
      reportForm.addEventListener('submit', () => {
        // 延迟500ms执行，确保POST请求已经发出
        setTimeout(() => {
          reportForm.reset() // 重置表单，要跳转就替换为 location.href = '目标地址'
        }, 500)
      })
    </script>
  </block body>
  

• 两步响应逻辑：POST请求处理完成后不直接返回文件，先返回302重定向到目标页面，目标页面加载时自动触发指向文件下载接口的请求，即可同时完成页面跳转和文件下载。

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