Express设置200状态码却返回404问题排查求助

当处理Buffer响应时，你通过PassThrough流+pipe的方式传输数据，但这个操作是异步的。路由函数执行完毕后，Express会继续遍历后续的中间件/路由规则，最终匹配到默认的404处理逻辑，直接覆盖了你之前设置的200状态码。

而JSON响应路径正常，是因为res.json()会同步结束响应流程，阻止Express继续执行后续的中间件或路由匹配，因此状态码能保持正确。另外日志里显示的"204b sent"也验证了这一点——实际发送的是404默认响应内容，而非你准备的几MB Buffer数据。

方案1：直接使用Express内置方法发送Buffer（推荐） #

对于几MB级别的Buffer，完全不需要用流处理。Express的res.send()支持直接传入Buffer，会自动设置Content-Type、Content-Length头，并同步结束响应，彻底避免后续逻辑覆盖状态码：

修改setResponseWithStatusCode的Buffer分支代码：

if (Buffer.isBuffer(result)) {
  res = res.setHeader('Content-Type', 'application/octet-stream');
  // 替换流逻辑为res.send()
  res = res.send(result as Buffer);
} else {
  res = res.json(result);
}

方案2：若必须使用流处理（如超大文件） #

如果因为业务需求必须用流，则需要确保Express不会继续执行后续逻辑：

1. 在路由处理函数中不要调用next()，阻止中间件链继续执行；
2. 监听流的错误事件，避免静默失败导致状态码异常：

private setResponseWithStatusCode<TResult>(
    result: TResult, 
    httpStatusCode: number, 
    response: Response): Response {

    let res = response;
    res = res.status(httpStatusCode);
    if (Buffer.isBuffer(result)) {
      res = res.setHeader('Content-Type', 'application/octet-stream');
      const stream = new PassThrough();
      stream.end(result as Buffer);
      // 监听流错误，避免静默失败
      stream.on('error', (err) => {
        console.error('Stream transmission failed:', err);
        res.status(500).end('Internal Server Error');
      });
      stream.pipe(res);
    } else {
      res = res.json(result);
    }

    console.info(`Returning HTTP ${res.statusCode}.`);

    return res;
  }

同时在路由函数中确保不触发后续逻辑：

router.get('/your-target-route', (req, res, next) => {
  const bufferData = getYourBufferData();
  yourService.setResponseWithStatusCode(bufferData, 200, res);
  // 不要调用next()，终止中间件链
});

内容的提问来源于stack exchange，提问作者Fredrik Mörk