enctype 是决定浏览器如何编码表单数据的关键属性；含文件上传时必须设为 multipart/form-data，否则文件无法提交；默认 application/x-www-form-urlencoded 仅适用于纯文本字段。
form enctype 是什么，什么时候必须改
它不是可有可无的配置项，而是决定浏览器怎么打包表单数据发给后端的关键开关。默认值 application/x-www-form-urlencoded 适合纯文本字段；一旦你加了 <input type="file">，就必须改成 multipart/form-data，否则文件根本传不上去——后端收到的只是空文件或报错 Missing boundary in multipart/form-data。
常见错误现象：
– 点提交没反应，或控制台报 400
– 后端收不到 req.file 或 $_FILES
– 文件字段显示为 [object File] 但实际没上传
使用场景只看一条：只要表单里含文件输入，enctype 就得是 multipart/form-data，没商量。
HTML 中设置 enctype 的正确写法
直接写在 <form></form> 标签上，别试图用 JS 动态改（除非你清楚知道后端能接住），更别漏掉引号。
立即学习“前端免费学习笔记（深入）”；
正确示例：
<form action="/upload" method="POST" enctype="multipart/form-data"> <input type="file" name="avatar"> <input type="text" name="username"> <button type="submit">上传</button> </form>
容易踩的坑：
– 写成 enctype=multpart/form-data（拼错、少引号、漏 en）
– 在 method="GET" 表单里设 enctype（GET 不支持文件上传，浏览器会忽略 enctype）
– 用 fetch 提交但没配 FormData，还硬套这个 enctype（HTML 属性对 JS 请求无效）
enctype="text/plain" 有什么用，谁还在用
它几乎没人用。规范里定义它是“可读性优先”的编码方式，把键值对转成类似 name=John Doe&city=New York 这种带空格和换行的明文，不转义特殊字符。但实际中：
– 大多数后端解析器不认它，PHP 的 $_POST 为空，Node.js 的 body-parser 默认不处理
– 空格、&、= 都原样传，容易被误解析
– 没有任何框架或 API 文档推荐它
结论：
– 别主动设 text/plain
– 如果看到别人用了，先确认后端是否真有对应解析逻辑
– 浏览器兼容性没问题，但“能跑”不等于“该用”
前后端不一致时最常出什么问题
前端设了 multipart/form-data，后端却用 urlencoded 解析器收——这是线上最常见的 400 错误来源之一。
典型表现：
– Express 里没装 multer，只用 express.urlencoded()，结果 req.body 是空对象，req.file 是 undefined
– Django 视图里没读 request.FILES，只查 request.POST
– Nginx 报 413 Request Entity Too Large，因为默认限制 1MB，而 multipart 请求体更大，且 Nginx 不会自动透传原始 body 给后端
检查顺序建议：
– 看浏览器 Network → Headers → Content-Type 是否含 multipart/form-data; boundary=...
– 看后端日志是否打印出文件名或大小
– 查后端中间件是否匹配 Content-Type，而非只看 method 或 path
边界值容易被忽略：boundary 是自动生成的，不能手写，也不能让后端自己猜——它必须由浏览器按规范生成并写进 header，后端解析器靠它切分字段。改错一个字符，整个请求就废。
