Express POST接口调用报ERR_HTTP_HEADERS_SENT与ENOENT错误

• 所有POST接口此前运行正常，无明确代码改动的前提下，Postman调用统一返回500服务端错误
• 控制台同步抛出两类关联报错：
  • 文件操作类ENOENT错误：文件重命名时目标路径不存在
  • HTTP协议类ERR_HTTP_HEADERS_SENT错误：响应头重复写入
• 已完成排查排除：请求字段与数据库、pgAdmin配置不匹配的可能性

1. 本地文件路径拼接逻辑错误
   现有代码把带http前缀的对外访问URL直接拼进了本地文件存储路径，最终生成的本地路径包含http:\localhost:5002/...这类不符合Windows/Linux文件系统规范的字符，导致文件重命名操作直接失败。
   举例：当前代码生成的目标存储路径类似./assets/diveSpot/http:/localhost:5002/assets/divespot/xxx.jpg，这类路径在本地磁盘中根本无法创建，直接触发找不到文件的错误。
2. 错误分支未中断执行
   文件重命名的错误分支中，调用res.send(500)返回错误后，没有加return中断后续代码执行：响应已经发送给客户端后，代码仍会继续执行数据库创建逻辑，待数据库操作完成后再次调用res.send()写入响应，直接触发“响应头已发送无法重复设置”的报错。
3. 附加的代码不规范问题：使用已废弃的res.send(状态码)写法，触发Express的废弃提示。

• 拆分本地存储路径、对外访问URL的拼接逻辑：
  • 计算本地存储路径时，仅使用文件名拼接相对路径，不要混入http前缀的访问地址
  • 数据库存储的photos字段单独拼接可对外访问的完整URL
• 所有错误响应分支必须加return中断后续代码，避免重复调用响应方法
• 替换不规范的响应写法，用res.sendStatus(状态码)替代res.send(纯数字状态码)

修正后的接口示例 #

exports.createDiveSpot = async (req, res) => {
  // 生成本地存储用的纯文件名
  const localFileName = `${req.file.filename}-${req.file.originalname}`
  // 拼接本地存储的相对路径
  const localStorePath = `./assets/diveSpot/${localFileName}`
  // 单独拼接数据库存储的对外访问URL
  const accessUrl = `http://localhost:5002/assets/divespot/${localFileName}`

  fs.rename(req.file.path, localStorePath, (err) => {
    if (err) {
      console.log('文件移动失败:', err)
      // 错误分支中断执行，避免后续重复写响应
      return res.sendStatus(500)
    }

    diveSpot.create({
      diveLocation: req.body.diveLocation,
      diveRegionID: req.body.diveRegionID,
      diveTypeID: req.body.diveTypeID,
      diveSpotDescription: req.body.diveSpotDescription,
      photos: accessUrl,
    })
      .then((data) => res.send(data))
      .catch((dbErr) => {
        return res.status(500).send({
          message: dbErr.message || '创建潜水点位时发生未知错误',
        })
      })
  })
}

注：所有带文件上传逻辑的POST接口（如日志中提及的article创建接口）都存在完全一致的问题，需同步按照上述逻辑修正，即可批量解决所有POST接口的同类报错。

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