FormData.append()传文件无效主因是未正确传入File对象或字段名不匹配，且fetch上传时手动设置Content-Type会破坏boundary导致后端收不到文件，必须由浏览器自动设置。

FormData.append() 传文件时为什么没效果

常见原因是直接传 File 对象但没指定字段名，或误传了 input.files[0].name 字符串而非文件对象本身。浏览器会静默忽略非法参数，控制台也不报错。

• 必须用 input[type="file"].files[0]（File 实例）作为第二个参数，不能是路径字符串或 input.value
• 第一个参数（字段名）要和后端约定一致，比如后端 expect avatar，就写 formData.append("avatar", file)
• 如果选了多个文件，需循环调用 append()，或用相同字段名多次添加（如 formData.append("files", file1); formData.append("files", file2)）

fetch 上传 FormData 必须禁用 Content-Type

手动设置 Content-Type 会导致浏览器无法自动插入 boundary，服务端收不到文件。这是最常踩的坑。

• 完全不要在 headers 中设 Content-Type —— fetch 会自动设为 multipart/form-data; boundary=...
• 错误写法：

  fetch("/upload", {
    method: "POST",
    headers: { "Content-Type": "multipart/form-data" }, // ❌ 删掉这行
    body: formData
  });

• 正确写法：

  fetch("/upload", {
    method: "POST",
    body: formData // ✅ 让浏览器自动处理 headers
  });

XMLHttpRequest 和 fetch 在 FormData 上传中的关键差异

两者都支持，但错误处理和进度监听方式不同，影响调试效率。

NotebookLM CLI Cookies

使用 nlm CLI 检索并回答已上传至 NotebookLM 的文档问题。适用于用户需要查找信息、总结来源或查询特定笔记本时。

下载

• XMLHttpRequest 可用 upload.onprogress 监听上传进度，fetch 原生不支持（需用 ReadableStream + TransformStream 拦截，复杂度高）
• fetch 默认不带 cookie，如需认证，得加 credentials: "include"
• XMLHttpRequest 的 responseType = "json" 会自动解析，fetch 需手动调 res.json()

后端接收不到文件？先检查 enctype 和 input 属性

前端漏掉关键属性，表单会退化为普通文本提交，FormData 也救不了。

立即学习“前端免费学习笔记（深入）”；

• <form> 不需要 enctype（FormData 不依赖它），但若混用原生表单提交，必须设 enctype="multipart/form-data"
• <input type="file"> 必须有 name 属性，否则 input.files 虽可读取，但 FormData 构造时无法关联字段名
• 多文件上传要加 multiple 属性：<input type="file" name="photos" multiple>

实际上传逻辑里，边界值（空文件、超大文件、类型过滤）和后端字段映射才是出问题最多的地方，别只盯着 JS 写法。