enctype="multipart/form-data"是文件上传的硬性前提，必须显式设置在<form>标签上，搭配method="POST"，否则浏览器不会发送文件二进制内容；手动设置Content-Type而不使用FormData会导致boundary缺失，后端无法解析。
enctype="multipart/form-data" 是文件上传的硬性前提，不是可选项
只要表单里有 <input type="file">，enctype 就必须显式设为 multipart/form-data。浏览器默认用 application/x-www-form-urlencoded 编码，它会把整个表单转成 a=1&b=hello%20world 这种字符串——遇到文件输入，只传个空值或 C:\fakepath\abc.jpg 这类路径字符串，二进制内容直接丢弃。
这不是后端解析失败的问题，是请求体里压根没包含文件字节。你查 req.files 为空、request.FILES 为空、$_FILES 为空，根源都在这一环。
-
enctype必须写在<form>标签上，写在<input>上无效 - 拼写必须准确：
multipart/form-data，少个i（如mutlipart）或大小写混乱（如Multipart/Form-Data）都会退化为默认编码 - 必须搭配
method="POST"；GET不允许带 body，浏览器会静默忽略文件字段 - 动态创建表单时，
form.enctype = 'multipart/form-data'必须在提交前设置，否则仍走默认
为什么不能用 fetch + 手动 Content-Type 替代 enctype
用 JS 提交时，enctype 属性本身不生效，但很多人误以为“只要手动设 headers 就行”，结果卡在后端收不到文件。
关键在于：浏览器对 FormData 对象的处理是自动的。当你调用 new FormData(form) 或 formData.append('file', fileInput.files[0])，浏览器会自动生成正确的 Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryxxx。手动设 headers: { 'Content-Type': 'multipart/form-data' } 会丢失 boundary，后端解析器（如 multer、Flask 的 request.files）无法识别分隔符，直接报错或返回空。
- ✅ 正确：
fetch('/upload', { method: 'POST', body: new FormData(form) })—— 浏览器自动加头、注入 boundary - ❌ 错误：
fetch('/upload', { headers: { 'Content-Type': 'multipart/form-data' }, body: formData })—— boundary 缺失，后端解析失败 - ❌ 错误：
body: JSON.stringify({ file: input.files[0] })——[object File]字符串，不是二进制流 - ⚠️ 注意：
FormData.append()第二个参数必须是File实例，不是input.value（那是只读路径字符串）
application/x-www-form-urlencoded 和 text/plain 的真实行为边界
这两个值常被误用于“试试看”，但它们根本不能传文件，且行为差异容易误导排查。
application/x-www-form-urlencoded 是默认值，适合登录、搜索等纯文本场景。它会对中文、空格、emoji 做 URL 编码（空格→%20，你→%E4%BD%A0），后端需正确解码。但它完全不支持二进制，<input type="file"> 在这种编码下等同于不存在。
text/plain 更危险：浏览器用换行分隔字段，不做任何编码，比如 name=john doe\nage=25。它不标准、框架基本不解析，连字段结构都可能被破坏。唯一实用场景是临时抓包验证原始发送内容，但不能用于生产，也不能传文件。
- 不要用
text/plain调试文件上传——它连<input type="file">都不打包 - 若后端收到乱码，先确认是否误用了
application/x-www-form-urlencoded却试图解析文件字段 - ASP.NET Web Forms 中，
HtmlForm.Enctype必须在Page_Load早期赋值，晚了无效 - 混用文本和文件字段时，整个表单必须统一用
multipart/form-data，没有“部分字段单独编码”这回事
后端解析 multipart 的常见断点位置
前端配对了 enctype，不代表后端一定能拿到文件。multipart 解析依赖中间件或原生支持，漏配就会静默失败。
Node.js Express 默认不解析 multipart，必须用 multer；Flask 需明确调用 request.files.get('file') 而非 request.form.get('file')；PHP 要检查 $_FILES['file']['error'] === 0 而非只判空。
- Express + multer：没配
dest或storage，req.file为undefined，不是没传，是没落地 - Nginx 默认限制 1MB，超限返回
413 Request Entity Too Large，需调client_max_body_size - 字段名大小写敏感：前端
name="Avatar"，后端就得用req.files.Avatar，不是avatar - 多个同名
<input type="file" multiple>会被打包成数组，不是单个对象
真正容易被忽略的是：enctype 是表单级开关，一旦没配对，整个链路在第一环就断了——你看到的“后端收不到文件”，90% 情况下是浏览器根本没发。
