必须显式设置enctype="multipart/form-data"且method="post"（或put等带body的方法），否则浏览器不发送文件；默认application/x-www-form-urlencoded会丢弃二进制内容，仅传空值或fakepath字符串。
enctype="multipart/form-data" 必须配 method="POST"
浏览器只在 method="POST"（或 PUT 等带 body 的方法）下才真正使用 enctype；method="GET" 时该属性被完全忽略，文件字段变成空字符串或仅传文件名。常见错误是漏写 method，HTML 默认就是 GET，所以必须显式写 method="POST"。
后端解析中间件必须显式启用 multipart 解析
前端设对了 enctype，只是让浏览器发出了带 boundary 的请求体；后端若没对应解析器，req.files、$_FILES 或 request.FILES 全是空的——不是报错，而是“静默收不到”。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- Express + Multer：
app.post('/upload', upload.single('avatar'))，不能只app.use(multer())就完事 - Flask：
request.files.get('avatar')才能取文件，request.form.get('username')取文本；且要确认request.environ.get('CONTENT_TYPE', '').startswith('multipart/form-data') - PHP：
$_FILES['avatar']['error'] === 0才表示上传成功；error === 4是UPLOAD_ERR_NO_FILE，大概率是enctype没生效，不是配置问题 - Spring Boot：
@RequestPart("avatar") MultipartFile file，别用@RequestParam，它只处理文本字段
name 属性必须前后端严格一致且大小写敏感
<input type="file" name="avatar"> 对应后端代码里的 avatar 字符串，Avatar 或 AVATAR 都拿不到。常见错误是前端写 name="userAvatar"，后端却查 avatar，结果 req.files 显示有字段但值为 null。
- 多个文件用
name="photos"+multiple，后端需按数组方式接收（如 Multer 的upload.array('photos', 5)） - 文本字段和文件字段共存时，它们都走同一个
multipart请求体，但解析路径不同：文本进req.body或request.form，文件进req.files或request.files
调试时先看 Network 中的 Content-Type 头
Chrome DevTools → Network → 点开提交请求 → Headers → 查 Content-Type：
- 正确应为
multipart/form-data; boundary=----WebKitFormBoundaryxxx - 如果显示
application/x-www-form-urlencoded或根本没这个头，说明enctype没生效：可能是method写成了get，或被 JS 拦截后用fetch发送但没传FormData，或form标签上压根没写该属性 - 如果看到
Invalid boundary in multipart错误，通常是前端手动设置了Content-Type: multipart/form-data但没删掉浏览器自动生成的boundary参数——用FormData时，千万别手设headers
<form></form> 标签上、小写、拼写准确、配合 method="POST"，缺一不可。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
