文件上传失败首要检查enctype是否设为multipart/form-data，必须显式设置且不能拼错；method必须为post；asp.net需在oninit或page_load中用this.form.enctype设置；fetch时用formdata但勿手动设content-type。
文件上传失败，八成是 enctype 没设对——它不是可选项，而是决定浏览器是否真把文件字节发出去的开关。
必须设为 multipart/form-data 才能传文件
只要表单里有 <input type="file">，enctype 就必须显式写成 multipart/form-data。浏览器默认用 application/x-www-form-urlencoded，这个编码会 URL 转义所有内容，把图片、PDF 的二进制流硬生生转成乱码字符串，后端收到的就是损坏数据或空字段。
-
method必须是POST；GET忽略enctype，根本没请求体可传文件 - 别拼错：
mutlipart/form-data（少个 i）或multipart/formdata（缺斜杠）都会退化为默认编码 - 即使表单里只有 1 个文本框 + 1 个 file 输入，整个表单也得用
multipart/form-data，不能“混合编码”
ASP.NET Web Forms 中 HtmlForm.Enctype 的赋值时机很关键
在 .aspx 页面里直接写 <form runat="server" enctype="multipart/form-data"></form> 是无效的——ASP.NET 会覆盖它。必须在服务端代码中提前设置：
- 在
Page_Load或更早的OnInit里写：this.Form.Enctype = "multipart/form-data"; - 如果用了母版页（Master Page），要确认
this.Form指向的是最终渲染的那个<form></form>，必要时用Page.FindControl("form1")显式获取 - 设完之后，务必用浏览器 DevTools 查看最终 HTML 输出，确认
enctype="multipart/form-data"真出现在渲染后的<form></form>标签上
用 fetch + FormData 时，别手动设 Content-Type
当 JS 拦截表单提交、自己构造请求时，enctype 属性本身已不起作用。重点在 FormData 的使用方式：
- 创建
FormData实例并 append 文件或文本字段，然后直接传给fetch -
不要手动加
headers: { "Content-Type": "multipart/form-data" }——这会删掉浏览器自动生成的boundary，导致后端解析失败，报错如Invalid boundary in multipart - 如果表单嵌在
UpdatePanel或某些前端框架里，确保FormData构造时真正拿到了File对象，而不是只取了input.value（那只是文件名字符串）
后端收不到文件？先看请求头里的 Content-Type
调试上传失败，第一眼就该盯 Network 面板里请求的 Content-Type 字段：
- 如果是
application/x-www-form-urlencoded，说明enctype没生效，或被 JS 覆盖，或母版页/控件逻辑覆盖了设置 - 如果是
multipart/form-data; boundary=----WebKitFormBoundary...，说明前端没问题，问题大概率在后端：没启用 multipart 解析器（如 Express 缺multer，Flask 没调request.files）、Nginx 限制了client_max_body_size、或字段名大小写不一致（<input name="Avatar">和后端读req.files.get('avatar')对不上）
最容易被跳过的点：enctype 不是“设了就完事”，它和 method、后端解析能力、甚至代理层配置是一整条链；任一环断开，文件就卡在半路，且前端几乎不报错。
