Node.js图片上传接口报Cannot set headers after they are sent错误如何解决

这个报错完全是代码逻辑错误导致的，报错的根本原因是：同一个HTTP请求中，你多次调用res.json()/res.send()向客户端返回响应，第一次返回响应后响应头已经发送给客户端，后续再尝试修改响应头、返回内容就会触发这个错误。

• 参数校验分支没有加return：校验不通过返回res.json()后，代码还会继续往下执行，后续的文件操作、数据库操作逻辑还会尝试再次返回响应
• 重复返回响应：你同时写了文件上传成功后的res.send()、数据库保存成功后的res.json()，两个逻辑都会触发响应返回，不管哪个先执行，后执行的都会报错
• 异步流程没有管控：你用了async标记接口，但文件移动、数据库保存都是回调/then的异步写法，没有做顺序控制，代码执行顺序完全混乱
• 变量引用错误：你没有定义sampleFile变量，前面获取的上传文件对象赋值给了photo，调用sampleFile.mv会直接抛未定义错误
• 非必填字段没有兼容：你明确说明photo是非必填项，但代码里直接读取req.files.photo赋值，用户没传图片时这里直接报错
• 错误分支变量引用错误：数据库保存失败的catch分支里引用了只有then分支才有的result变量，会触发未定义报错

可以把所有异步逻辑改成async/await写法统一管控流程，避免回调地狱和执行顺序混乱，修复后的参考代码如下：

const path = require('path')

router.post('/problem', catchAsync (async (req, res) => {
  const { title, description, solution } = req.body;
  let photoPath = '';

  // 1. 参数校验，加return终止后续逻辑
  if (!title || !description || !solution) {
    return res.json({
        status: "FAILED",
        message: "Please provide a title, description and solution!"
    })
  }

  // 2. 兼容非必填的photo字段
  if (req.files && req.files.photo) {
    const photo = req.files.photo;
    // 用path拼接路径，避免不同系统路径分隔符问题
    const uploadPath = path.join(__dirname, 'uploads', photo.name);
    // 把回调写法改成promise写法适配await
    await new Promise((resolve, reject) => {
      photo.mv(uploadPath, err => {
        if (err) return reject(err)
        resolve()
      })
    })
    photoPath = uploadPath
  }

  // 3. 数据库保存用await写法
  try {
    const newProblem = new Problem({
        title,
        description,
        solution,
        photo: photoPath
    });
    await newProblem.save()
    // 整个逻辑唯一的成功返回
    return res.json({
        status: "SUCCESS",
        message: "Success",
        data: newProblem
    })
  } catch (err) {
    console.log(err);
    // 唯一的失败返回
    return res.json({
        status: "FAILED",
        message: "Error"
    })
  }
}))

• 所有返回响应的地方都加了return，确保执行到对应分支后直接终止后续代码
• 全程用async/await管控异步流程，确保逻辑按顺序执行，不会出现提前返回的问题
• 兼容了photo非必填的场景，没传图片时不会走上传逻辑
• 修复了所有变量引用错误的问题
• 用path.join拼接路径，避免不同操作系统路径分隔符不兼容的问题

你之前直接传入本地路径字符串的操作是错误的，正确的文件上传调试步骤：

• 打开Postman对应请求的Body页签，选择form-data格式
• 找到photo字段，点击字段右侧的下拉选项，把类型从Text改为File
• 点击Select Files按钮选择本地要上传的图片，再发送请求即可

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