最常见原因是表单未设enctype="multipart/form-data"，导致浏览器用默认application/x-www-form-urlencoded编码丢弃文件内容，request.files为空；AJAX上传时还易因手动设Content-Type、误append DOM元素或未置processData=false等破坏boundary。
Flask request.files 为空的最常见原因
不是后端没写对，也不是前端完全没发，90% 是表单没声明 enctype="multipart/form-data"。HTML 表单默认用 application/x-www-form-urlencoded 编码，它会把文件内容丢掉，只传个空名——request.files 自然就是空的 ImmutableMultiDict([])。
必须显式写：<form method="post" enctype="multipart/form-data">
同时确保 <input type="file" name="image"> 的 name 和后端 request.files.get("image") 完全一致（大小写敏感）。
用 Chrome DevTools 的 Network → Payload 标签页确认：请求体里有没有以 ------WebKitFormBoundary 开头的分隔符。没有？说明根本没走 multipart 流程。
AJAX 上传时 request.files 为空的典型误操作
用 fetch 或 jQuery.ajax 提交时，容易在两个地方踩坑：
立即学习“Python免费学习笔记（深入）”；
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 前端把
<input type="file">DOM 元素直接append进FormData，比如form_data.append("file", inputEl)—— 正确做法是取inputEl.files[0] - 用 jQuery 时没关自动处理：
contentType: false和processData: false必须同时设为false；否则 jQuery 会强行设置Content-Type并序列化数据，破坏 multipart 边界 - 用
fetch时手动设置了headers: { "Content-Type": "multipart/form-data" }—— 这是错的，浏览器必须自己生成带 boundary 的真实类型，手设会覆盖它
文件读取后保存为空（0KB）的根本原因
调了 pd.read_excel(file) 或 Image.open(file) 后再 file.save()，结果存了个空文件？因为 file 是个类似 BytesIO 的流对象，read() 一次就把指针拉到末尾了，save() 从末尾开始写，自然啥也没有。
两种安全解法：
- 读完立刻
file.seek(0)把指针拨回去（前提是没 close、没 read 多次） - 更推荐：一次性
file_bytes = file.read()，之后用io.BytesIO(file_bytes)交给 Pandas 或 Pillow，再直接用file_bytes写磁盘——彻底避开指针问题
上传成功但图像处理报 “got empty file”
这个错误不是 Flask 没收到，而是你拿到的文件对象本身内容为空。常见于：
- 用户点了“上传”但根本没选文件（
file.filename为空或file.content_length == 0） - 文件在传输中被截断（Nginx 返回 413、或客户端网络中断），后端收到的是不完整流
- 后端校验逻辑有 bug，比如用
file.filename.split(".")[-1].lower()取后缀，但文件名没点（如photo），导致后缀为空，后续跳过保存 - Pillow 打开时报错前没检查
if not file or file.content_length == 0:就直接传给Image.open()
真正容易被忽略的是：即使 request.files 不为空，file.stream 也可能已关闭或耗尽——务必在任何处理前先检查 file and file.filename and file.content_length > 0。
