enctype="multipart/form-data" 是强制要求，只要表单含 file 输入就必须显式设置且 method="POST"；否则后端收不到文件，因仅该编码支持二进制分块传输，其他类型会丢失原始字节或解析失败。
enctype="multipart/form-data" 是强制要求，不是可选项
只要表单里有 <input type="file">，就必须在 <form> 标签上显式写 enctype="multipart/form-data" 且 method="POST"。浏览器不会自动补全，也不接受默认值——设错或漏设，后端收不到文件（比如 request.files 或 MultipartFile 为空）。
常见错误现象包括：
- 前端选了文件、点了提交，但后端日志里没打印出任何文件字段
- 用
application/json提交，后端收到的是[object File]字符串 - 用
application/x-www-form-urlencoded（默认），文件内容被 URL 编码成乱码，原始字节丢失
原因很简单：multipart/form-data 是唯一能携带原始二进制分块（含 Content-Disposition 和边界分隔符）的编码格式；其他类型压根不支持这种结构。
boundary 分隔符由浏览器自动生成，不可手动干预
HTTP 请求头中出现的 Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW 是浏览器根据当前会话动态生成的，不是固定字符串，也不能在前端 JS 里硬编码或覆盖。
立即学习“前端免费学习笔记（深入）”；
这意味着：
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
- 用
fetch+FormData时，不要手动设置Content-Type头，否则浏览器会禁用自动 boundary 插入，导致后端解析失败 - 用
XMLHttpRequest时同理：调用xhr.send(formData)即可，别加xhr.setRequestHeader('Content-Type', ...) - curl 测试时必须用
-F参数（如curl -F "file=@test.jpg"），它会自动构造合法的 multipart 请求体；若用-d手动拼接，几乎必然出错
多文件上传时 name 属性必须统一，且后端要匹配接收方式
<input type="file" name="avatar" multiple> 看似合理，但实际会导致不同框架行为不一致：
- Spring Boot 中，
@RequestParam("avatar") MultipartFile[] files可以正常接收多个文件 - Express + multer 中，必须用
upload.array('avatar')，不能用upload.single() - PHP 的
$_FILES['avatar']是嵌套数组结构（name、tmp_name等字段都是数组），需用foreach遍历
容易踩的坑：
- 前端用了
multiple，但后端仍按单文件处理（如只取req.file），结果只拿到第一个 - name 值带方括号（如
name="files[]"）在某些旧框架里反而触发异常，现代框架（Spring Boot、Express v5+）已不推荐 - iOS Safari 16.3 及更早版本会静默忽略
multiple，用户点选后仍只返回一个文件，需 JS 检查input.files.length并提示
文件字段和文本字段共存时，避免混淆 name 冲突
一个典型的混合表单像这样：
<form enctype="multipart/form-data" method="POST"> <input type="text" name="title"> <input type="text" name="author"> <input type="file" name="cover"> <input type="file" name="content"> </form>
此时后端必须区分两类字段：
- 文本字段（
title、author）在 multipart 请求中仍是普通 part，但Content-Type缺失，Content-Disposition中只有name，没有filename - 文件字段（
cover、content）的 part 一定含filename和Content-Type（如image/png）
所以后端解析逻辑不能只靠字段名判断类型——得看 part 是否含 filename。Spring Boot 的 @RequestParam 和 @RequestPart 就是为此设计：@RequestParam 拿文本，@RequestPart 拿文件（或整个对象），避免类型误判。
真正容易被忽略的是：当文本字段名和文件字段名相同时（比如都叫 data），部分老框架会覆盖，只剩最后一个；现代框架一般按顺序保留为数组，但语义已混乱，应严格避免。
