enctype="multipart/form-data"是文件上传唯一合法的编码格式，因它通过边界分隔符区分文本与二进制文件，确保服务端准确提取原始字节；其他编码如application/json或x-www-form-urlencoded会导致文件损坏或丢失。
enctype="multipart/form-data" 是唯一合法取值，别试别的
只要表单里有 <input type="file">，enctype 就必须是 multipart/form-data，没有例外。浏览器默认用 application/x-www-form-urlencoded，它会把二进制文件头（比如 JPEG 的 0xFF 0xD8）强行 URL 编码，后端收到的就是损坏数据或空文件。你改用 text/plain 也无效——它不带 Content-Disposition 和 filename 字段，服务端根本分不清哪段是文件、哪段是文本。
常见错误：只写 method="POST" 却漏掉 enctype，结果 req.files 或 $_FILES 始终为空；或者在 Vue/React 里用 @submit.prevent 拦截后手动发请求，却忘了 FormData 需要靠 fetch 自动设置 Content-Type，此时 enctype 属性本身已不生效。
multiple + name 一致性决定多文件能否被后端识别为数组
前端加了 multiple，不代表后端自动收到数组。关键在 name 属性是否统一且可被后端解析为多值：
-
<input type="file" name="photos" multiple>—— Express 的upload.array('photos')、Spring Boot 的@RequestParam("photos") MultipartFile[]、PHP 的$_FILES['photos']['name']数组都依赖这个精确的 key 名 - 别写
name="photos[]"：现代框架（如 Express 4.17+、Spring Boot 2.5+）不再依赖方括号语法，反而可能因解析逻辑差异导致只取到第一个文件 - 多个
<input>标签必须共用同一个name，大小写和空格都不能错；用FormData.append('photos', file)手动添加时，key 名也必须完全一致
调试时直接看 Network → Payload，确认每个文件是否作为独立条目出现，而不是合并成一个 blob 或只有一项。
立即学习“前端免费学习笔记（深入）”；
移动端兼容要注意 iOS 16.4 以下不支持 multiple
iOS 16.4 是分水岭：之前版本的 Safari 对 multiple 属性支持极差，即使写了，用户也只能选一个文件。这不是 bug，是 WebKit 的历史限制。如果你的用户群包含大量旧版 iOS 设备，得降级处理：
- 用
input.files.length === 0判断是否真有文件，别信value（它永远只显示第一个文件的伪造路径） - 对 iOS 16.3 及更早设备，提示“请逐个上传”或改用第三方 SDK（如 Uppy）兜底
- 不要依赖
input.files的 length 来做 UI 状态判断，先检测HTMLInputElement.multiple是否为true，再结合 UA 判断 iOS 版本
分片上传必须绕开 enctype，否则协议层就失败
分片上传和 enctype="multipart/form-data" 在 HTTP 协议层互斥。表单提交是原子操作，整个 body 被打包成一个带 boundary 的大块；而分片需要多次独立请求，每次传一段字节范围（blob.slice()）加元数据（chunk_index, file_id）。只要你调用了 File.prototype.slice()，就必须放弃 <form> 提交路径。
常见错误现象：<form enctype="multipart/form-data"> 里塞了 <input type="file">，再用 JS 切片 + fetch 发请求——表面代码跑通，但后端收不到文件内容，因为浏览器根本没走 multipart 流程，只是发了个空 body 或错乱的 FormData。此时服务端不能依赖 $_FILES 或 req.files，得从 php://input 或 raw body 解析二进制，再从 $_POST 或 JSON body 读元数据。
