Node.js/Express中res.write失效但res.send正常的原因排查

我之前在Express项目里也碰到过一模一样的情况！结合你提到刚用Promise重构代码的背景，核心问题大概率是异步流程里调用res.write/res.end的时机不对，或者忽略了Express响应机制的细节——毕竟res.send和res.write/res.end的工作方式差异很大。

最常见的原因：异步流程中提前调用了res.end #

Promise是异步执行的，如果你的res.end()写在了Promise回调之外，会先于res.write执行，导致响应提前结束，后续的写入操作会被Express静默忽略（不会报错，但也不会发送数据）。而res.send是在Promise的then回调里调用的，能保证数据准备好后再发送并结束响应，所以正常工作。

错误示例 #

app.get('/api/data', (req, res) => {
  // 异步Promise操作
  fetchDataFromDB()
    .then(data => {
      res.write(JSON.stringify(data));
    });
  
  // 这里会先执行，此时res.write还没运行
  res.end();
});

修复方案 #

把res.end()移到Promise的回调内部，确保所有数据写入完成后再结束响应：

app.get('/api/data', (req, res) => {
  fetchDataFromDB()
    .then(data => {
      res.write(JSON.stringify(data));
      res.end(); // 现在时机正确了
    })
    .catch(err => {
      // 别忘了捕获错误，避免请求挂起
      console.error('Fetch data error:', err);
      res.status(500).send('Failed to fetch data');
    });
});

容易忽略的细节：未设置响应头 #

res.send会自动根据发送的内容帮你设置Content-Type、Content-Length等响应头，但res.write需要你手动配置。如果没设置正确的响应头，客户端可能无法解析收到的数据，看起来像是没有内容发送。

修复方案 #

在开始写入数据前，先设置对应的响应头：

app.get('/api/data', (req, res) => {
  // 根据你的数据类型设置Content-Type
  res.setHeader('Content-Type', 'application/json');
  
  fetchDataFromDB()
    .then(data => {
      res.write(JSON.stringify(data));
      res.end();
    })
    .catch(err => {
      res.status(500).send('Internal Server Error');
    });
});

隐藏的坑：Promise链未捕获错误 #

虽然你说没有产生任何错误，但如果Promise内部抛出异常且没有被catch捕获，then回调就不会执行，导致res.write和res.end都没被调用，请求会一直挂起，客户端收不到任何响应。而res.send如果是在正确的错误处理流程里，会返回错误信息，但如果你的res.send只在then里，那可能当时Promise没有报错。

修复方案 #

务必给Promise链加上catch块，捕获所有可能的异常，确保响应能正常结束：

app.get('/api/data', (req, res) => {
  res.setHeader('Content-Type', 'application/json');
  
  fetchDataFromDB()
    .then(data => {
      res.write(JSON.stringify(data));
      res.end();
    })
    .catch(err => {
      console.error('Error:', err);
      res.status(500).send('Something went wrong');
    });
});

总结 #

你遇到的问题本质是异步流程中响应操作的时机和细节处理不到位。res.send是Express封装的便捷方法，帮你处理了响应头、结束时机等细节；而res.write/res.end是更底层的流式操作，需要你严格控制执行顺序，同时手动处理响应头和错误捕获。调整后应该就能正常工作了！

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