Flask使用send_file()报错TypeError: 缺失必填位置参数'environ'如何解决？

报错根本原因 #

• 错误导入了werkzeug底层的send_file工具，而非Flask封装后的同名方法。werkzeug原生的send_file需要手动传入请求的environ参数，而Flask封装的版本会自动从请求上下文中获取该参数，无需手动传递。
• 之前修改时传入app作为environ参数完全错误，environ是当前HTTP请求的环境变量对象，而非Flask应用实例，类型不匹配才触发第二个报错。

解决步骤 #

1. 修改导入语句
   删除from werkzeug.utils import send_file，改为从flask包直接导入所需方法：

from flask import Flask, send_file
import os

2. 修正路由代码，建议搭配绝对路径使用，避免工作目录变动导致找不到文件：

app = Flask(__name__)

@app.route('/sessions/csv_file')
def get_csv_file():
    # 拼接csv文件的绝对路径，确保不管启动目录在哪都能找到文件
    csv_path = os.path.join(app.root_path, 'sessions.csv')
    return send_file(
        csv_path,
        mimetype='text/csv',
        as_attachment=True,
        download_name='sessions.csv'
    )

if __name__ == '__main__':
    app.run(debug=True)

补充说明 #

• app.root_path是Flask应用实例的根目录（即主启动文件所在的目录），用os.path.join拼接路径可以兼容不同操作系统的路径格式。
• CSV文件的正确MIME类型为text/csv，之前写的csv不符合规范，部分浏览器可能识别异常。
• 只需把sessions.csv放在和启动py文件同一目录下，访问对应路由即可正常触发下载。

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