Node.js中Multer报unexpected end of form错误如何修复

Node.js服务端对接文件上传能力时，文件可正常抵达服务端，但调用multer提供的upload.single中间件处理上传请求时，固定抛出unexpected end of form错误。

现有实现代码 #

const upload = multer({ dest: "../../uploaded_images" });    
router.patch("/profile", upload.single("profileImage"), (req, res) => {   
    console.log(req.files) // 移除upload.single("profileImage")中间件时，此处可正常打印名为profileImage的文件信息
    res.send("")
})

项目结构参考 #

按优先级逐一排查修复即可：

• 修正上传目录路径配置
  当前配置的../../uploaded_images是相对路径，解析基准是Node服务的启动目录，而非当前路由文件所在目录，路径解析错误会导致multer写入文件失败，触发表单解析异常。改用path模块拼接绝对路径可彻底解决路径问题：

  const path = require('path')
  // 基于当前路由文件所在目录，拼接得到上传目录的绝对路径
  const upload = multer({ dest: path.join(__dirname, "../../uploaded_images") });
  

  需提前创建好uploaded_images目录，或给multer配置自动创建目录的逻辑，避免目录不存在导致写入失败。
• 排查中间件顺序问题
  确保在/profile路由的处理链中，express.json()、express.urlencoded()、body-parser等会消费请求流的中间件，没有放在upload.single之前执行。这类中间件会提前读取请求体流，后续multer拿到的是被截断的不完整流，就会抛出表单意外结束的错误。
• 校验请求配置
  • 前端发送请求时Content-Type必须为multipart/form-data，不要手动设置boundary值，交由浏览器/请求库自动生成
  • 前端上传的文件字段名必须和upload.single()传入的参数完全一致，此处为profileImage，大小写需严格匹配
• 修正文件信息取值逻辑
  upload.single()处理单文件上传时，文件信息会挂载在req.file属性上，req.files是多文件上传场景（upload.array/upload.fields）的属性，不要写错取值字段。

内容的提问来源于stack exchange，提问作者warre