enctype="multipart/form-data"是唯一支持文件上传的表单编码类型，必须配合method="POST"使用，且需服务端专用中间件解析，否则文件无法提交成功。
enctype="multipart/form-data" 是唯一能传文件的取值
普通表单提交默认用 application/x-www-form-urlencoded，它会把文件字段变成空字符串或[object File]这类无意义文本，后端根本收不到原始二进制数据。只有显式设成 multipart/form-data，浏览器才会按 RFC 7578 封装文件内容为多部分边界（boundary）格式，让后端能解析出文件名、类型和字节流。
常见错误是只写了 <input type="file"> 却漏掉 enctype，或者误用 text/plain（HTML 标准里它不被支持用于文件上传）。
-
enctype必须写在<form>标签上，不能写在 input 上 - 只要表单里有任何一个
<input type="file">，整个表单就必须用multipart/form-data - 即使同时提交文本字段（如
<input name="title">），它们也会被一起打包进同一个 multipart 请求体，无需额外处理
method="POST" 不可省略
enctype="multipart/form-data" 只对 POST 请求生效。GET 请求根本无法携带文件数据——URL 长度限制、编码方式、服务器路由逻辑都不支持。如果用了 GET，浏览器可能静默忽略文件字段，或报 405 Method Not Allowed。
实操中容易忽略的是：某些前端框架（如 Vue 的 @submit.prevent）会拦截原生提交，但没手动构造 FormData 或设置请求头，结果还是发出了普通 POST，导致后端收不到文件。
立即学习“前端免费学习笔记（深入）”；
- 检查 Network 面板里的请求方法是否为
POST - 确认请求头中存在
Content-Type: multipart/form-data; boundary=----... - 若用 fetch 提交，不要手动设
Content-Type，让浏览器自动生成带 boundary 的 header
name 属性决定后端接收的字段名
文件字段的 name 值，直接对应后端解析时的键名。比如 <input type="file" name="avatar">，Node.js 的 multer 中就用 req.file 或 req.files.avatar 取值；PHP 的 $_FILES['avatar'] 也是同理。
多个文件上传时要注意：name 相同 + multiple 属性，后端收到的是数组；name 不同则各自独立。别用 name="file[]" 这种 PHP 风格写法——现代后端框架不依赖这个约定。
- 单文件：确保
<input type="file" name="cover">和后端代码里写的字段名完全一致（区分大小写） - 多文件：用
<input type="file" name="photos" multiple>，而非多个name="photo1"、name="photo2" - 混合字段：文本输入框也要有
name，否则不会随文件一起提交
服务端必须匹配 enctype 解析逻辑
前端设了 enctype="multipart/form-data"，后端却用普通 body-parser 解析，结果是空对象或报错 request entity too large。因为 multipart 数据不是 JSON 或 URL 编码字符串，而是分段二进制流。
不同语言的典型处理方式差异很大：Express 需要 multer，FastAPI 用 UploadFile 参数声明，Spring Boot 要配 MultipartResolver。没配对中间件，请求体就卡在网关层，根本到不了业务代码。
- Node.js：不用
app.use(express.json())处理文件上传，必须用multer().single('avatar')这类专用中间件 - Python Flask：禁用
request.get_json()，改用request.files.get('avatar') - 注意临时文件路径权限、上传大小限制（如 Nginx 的
client_max_body_size）
name、忘了 POST、后端没挂 multipart 解析器——都会让文件消失得毫无痕迹。最常被跳过的其实是服务端配置，而不是 HTML 写法。 
