enctype="multipart/form-data"是文件上传的唯一正确值；不设置或设错会导致后端收不到文件甚至整个表单解析失败，浏览器仅在此值下以二进制块编码文件，其他值会丢弃文件内容。
enctype="multipart/form-data" 是上传文件的唯一正确值
不设或设错 enctype，<input type="file"> 选了文件也白搭——后端收不到文件字段，甚至整个表单数据都解析失败。浏览器只在 enctype="multipart/form-data" 下才会把文件内容以二进制块（part）方式编码进请求体，其他值如 "application/x-www-form-urlencoded" 或 "text/plain" 会直接丢弃文件控件的值，只传个空字符串或文件名（不可靠且无意义）。
不写 enctype 属性时的默认行为要特别小心
如果 <form></form> 标签完全没写 enctype，浏览器按规范会默认使用 "application/x-www-form-urlencoded"。这个值对纯文本字段没问题，但遇到 type="file" 就彻底失效：文件选择后，提交时该字段在 FormData 中为空，Node.js 的 req.body 或 Python Flask 的 request.form 里根本找不到它，更别提 request.files。
- 必须显式声明：
<form enctype="multipart/form-data"></form> - 即使表单里只有一个
<input type="file">，其他全是文本框，也得加 - 注意大小写：HTML 不区分大小写，但写成
MULTIPART/FORM-DATA容易让协作者误判，统一小写最稳妥
用 JavaScript 提交时 FormData 会自动处理 enctype
如果你用 fetch() 或 XMLHttpRequest 手动构造请求，不用管 enctype 属性——它只作用于原生表单提交。重点在于是否用 FormData 对象收集数据：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- ✅ 正确：创建
new FormData(formElement)，再传给fetch()，浏览器自动设请求头Content-Type: multipart/form-data; boundary=... - ❌ 错误：手动拼 JSON 并设
Content-Type: application/json，文件会被转成[object File]字符串，后端收不到二进制流 - ⚠️ 注意：
FormData.append('file', input.files[0])中的input.files[0]必须是File实例，不能是input.value（那是路径字符串，无用）
后端接收失败？先确认 enctype 和请求头是否匹配
常见报错如 Node.js Express 报 req.file is undefined，或 Python FastAPI 中 File(...) 参数为空，大概率不是后端代码问题，而是前端没发对。抓包看请求头：
立即学习“前端免费学习笔记（深入）”；
- 检查
Content-Type请求头是否为multipart/form-data; boundary=xxxx - 如果看到
application/x-www-form-urlencoded，说明enctype没生效（可能是 JS 阻止了默认提交但没用 FormData） - 如果用了框架中间件（如 Express 的
multer），确保它挂载在路由之前，且没有被其他 body-parser 中间件提前消费请求流
边界（boundary）字符串由浏览器自动生成，不需要、也不能手动指定；强行覆盖反而会导致解析失败。
