文件成功上传至Express Node服务器却返回net::ERR_EMPTY_RESPONSE错误排查

从你描述的现象和代码来看，核心问题出在服务器端没有正确向客户端返回HTTP响应，导致前端请求超时并抛出ERR_EMPTY_RESPONSE错误。

具体原因拆解 #

1. 首次上传时无响应返回：你的Express路由处理函数里，完成文件上传后没有调用res.send()、res.json()这类方法返回响应。客户端的POST请求会一直等待服务器回复，直到浏览器判定超时，就会抛出空响应错误。而文件虽然已经被multer保存到目录，但后续的读取和数据库插入逻辑可能因为请求超时被中断，或者根本没机会执行。
2. 二次上传正常的假象：当你再次上传同一文件时，可能是因为之前的业务代码残留（或者multer覆盖文件时的处理更快速），加上测试时的偶然状态差异，但本质还是服务器端响应的问题——如果服务器始终不返回响应，二次上传最终也会出问题。

分步解决方案 #

1. 先确保服务器返回基础响应

修改你的路由处理函数，在文件上传完成后立即返回一个成功响应，哪怕后续业务逻辑还在异步执行（避免阻塞响应）：

router.post('/debt-upload', upload.array('files', 10), async (req, res, next) => {
  // 先返回响应，告诉客户端上传成功，避免超时
  res.status(200).json({ 
    success: true, 
    message: '文件上传成功，正在处理数据' 
  });

  // 后续的文件读取、数据库插入逻辑放到异步操作里
  try {
    console.log('开始处理上传的文件:', req.files);
    // 这里写你的文件读取和数据库插入代码
    // 示例：const data = await readExcelFile(req.files[0].path);
    // 示例：await db.query('INSERT INTO ...', data);
  } catch (err) {
    console.error('处理文件时出错:', err);
    // 如果需要通知客户端处理失败，可以用websocket或者后续查询接口，不阻塞初始响应
  }
});

2. 捕获业务逻辑中的异常

如果文件处理逻辑可能抛出错误，一定要用try-catch包裹，避免错误导致整个路由处理函数崩溃，确保响应能正常发送：

router.post('/debt-upload', upload.array('files', 10), async (req, res, next) => {
  try {
    // 先处理文件上传后的业务逻辑
    console.log('上传的文件:', req.files);
    // 读取文件、插入数据库的代码...

    // 业务逻辑完成后返回响应
    res.status(200).json({ 
      success: true, 
      message: '文件上传并处理完成',
      data: /* 返回处理结果 */
    });
  } catch (err) {
    console.error('上传处理失败:', err);
    // 返回错误响应
    res.status(500).json({ 
      success: false, 
      message: '文件处理失败',
      error: err.message 
    });
  }
});

3. 前端请求添加超时设置

在前端请求里设置超时时间，避免无限制等待：

onDrop(acceptedFiles, rejectedFiles) {
  const req = request.post(burl + 'odx/debt-upload')
    .timeout(10000); // 设置10秒超时

  _.forEach(acceptedFiles, (file) => {
    req.attach('files', file);
    console.log(file.name);
  });

  req.end((err, res) => {
    if (err) {
      console.log('请求错误:', err);
      // 这里可以给用户提示，比如"上传超时，请重试"
      return;
    }
    console.log('响应结果:', res.body);
    // 处理成功后的逻辑
  });

  this.showFiles(acceptedFiles);
}

4. 避免multer文件覆盖问题

你的multer配置用了file.originalname作为文件名，会导致同名文件被覆盖。如果业务需要避免覆盖，可以修改文件名，比如加上时间戳：

filename: (req, file, callback) => {
  // 生成唯一文件名，避免覆盖
  const uniqueName = `${Date.now()}-${file.originalname}`;
  callback(null, uniqueName);
}

验证方法 #

先注释所有业务逻辑，只保留返回响应的代码，测试首次上传是否还会报错。如果不报错了，再逐步加回业务逻辑，用try-catch捕获错误，确保每一步都能返回响应。

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