该用 send_file() 时：处理动态路径、内存流、已打开文件或需自定义响应头；send_from_directory() 仅限安全静态文件，严格校验路径是否在预设根目录内且无遍历风险。
什么时候该用 send_file()，而不是 send_from_directory()
直接看行为差异：如果你手头是一个已打开的文件对象、内存里的字节流，或者路径是动态拼接、不在固定目录下（比如从数据库查出路径、临时生成的 ZIP），必须用 send_file()；而 send_from_directory() 只接受「安全的相对路径」+「预设根目录」，它会主动拦截上级路径（../）和绝对路径，本质是为静态文件服务的防护型接口。
常见错误现象：send_from_directory(root, path) 报 NotFound，但文件明明存在——大概率是 path 里带了 /static/ 前缀，或用了绝对路径；又或者 root 指向的是软链接目标之外的路径，导致校验失败。
-
send_file()支持io.BytesIO、open(..., 'rb')返回的文件对象，适合导出报表、生成 PDF 后直接响应 -
send_from_directory()的path参数不能含目录分隔符以外的任何路径遍历成分，连./file.txt都会被拒绝 - 如果 root 是
os.path.abspath('uploads')，那传入send_from_directory('uploads', 'a/b/c.pdf')才合法；传'../etc/passwd'或'/tmp/x.txt'直接 404
send_file() 怎么设对 Content-Type 和文件名
浏览器靠 Content-Type 决定是下载还是内嵌，靠 Content-Disposition 头里的 filename 决定保存名。Flask 默认根据文件扩展名猜类型，但容易错——比如 Excel 文件用 .xlsx 时可能被当成 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，但某些老 IE 只认 application/octet-stream。
实操建议：
- 显式传
mimetype参数，别依赖自动推断：send_file(f, mimetype='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet') - 中文文件名必须用
as_attachment=True+download_name（Flask 2.0+）或attachment_filename（旧版），否则乱码：send_file(f, as_attachment=True, download_name='报表2024.xlsx') - 如果文件没后缀（如导出无扩展名的 CSV 流），
mimetype必须手动写死为'text/csv'，否则可能是application/octet-stream，Chrome 会尝试解析而非下载
send_from_directory() 的路径校验到底卡在哪
它的校验逻辑很硬：先用 os.path.join(root, path) 拼出绝对路径，再用 os.path.realpath() 解析所有符号链接，最后检查这个真实路径是否以 os.path.realpath(root) 开头。只要中间有软链接跨出 root 范围，就 404。
典型翻车场景：
- 开发机上
uploads是软链接到/mnt/nas/uploads，但root写的是'uploads'——realpath(root)变成/mnt/nas/uploads，而你传的path='test.pdf'拼出来是/home/app/uploads/test.pdf，不匹配，404 - Windows 下大小写不敏感，但 Flask 校验走的是严格字符串前缀比对，
Root和root视为不同路径 - 路径末尾斜杠不统一：
send_from_directory('static/', 'js/app.js')和send_from_directory('static', 'js/app.js')行为一致，但前者在某些系统上可能多一层os.path.join导致意外
大文件下载卡住或内存爆掉怎么办
send_file() 默认把整个文件读进内存再发，几 MB 还行，几百 MB 就崩。而 send_from_directory() 底层其实也调用 send_file()，只是加了路径限制，同样吃内存。
关键解法是让 Flask 流式传输：
- 用
send_file(f, as_attachment=True, download_name=...)时，确保f是已打开的二进制文件对象（open(path, 'rb')），不是path字符串——这样 Flask 才能按 chunk 读 - 加
conditional=True参数，支持断点续传和 304 缓存，对大文件很实用：send_file(f, conditional=True) - 避免用
io.BytesIO(data)包整个大文件，那是自找死路；真要内存生成，得用io.BufferedRandom或分块写入临时文件再传
最易被忽略的一点：Nginx 或 Gunicorn 默认缓冲响应体，即使 Flask 流式发送，也可能被中间件攒满再吐给浏览器。上线前务必确认反向代理配置里关掉了 proxy_buffering（Nginx）或设对 --no-sendfile（Gunicorn）。
