如何用Winston捕获Express中的`Error: ENOENT: no such file or directory`错误？

我来帮你搞定这个Winston没捕获到文件不存在错误的问题！首先得搞清楚为什么你的try/catch没用——因为res.sendFile()是异步方法，它的错误不会触发同步的try/catch块，而是会通过Express的错误处理机制来传递，或者需要通过回调显式捕获。

下面给你两种靠谱的解决方案：

方案1：给sendFile添加回调捕获错误 #

直接在sendFile调用时传入回调函数，手动捕获错误并交给Winston记录，同时处理响应避免请求挂起：

app.get('/your-route', (req, res) => {
  const targetFile = '/path/to/your/file';
  res.sendFile(targetFile, (err) => {
    if (err) {
      // 用Winston记录详细错误信息，包括上下文
      logger.error('Failed to serve file', {
        errorCode: err.code,
        errorMessage: err.message,
        requestedFilePath: targetFile,
        clientRequestPath: req.path,
        stackTrace: err.stack
      });
      // 返回合适的HTTP响应
      res.status(err.status || 404).send('Requested file not found');
    }
  });
});

这种方法适合单个路由的精细控制，但如果有很多路由都用了sendFile，写起来会重复。

方案2：使用Express全局错误处理中间件（推荐） #

给整个应用添加一个全局错误处理中间件，统一捕获所有Express路由抛出的错误（包括sendFile的ENOENT错误），一次性搞定所有场景：

// 先定义所有业务路由
app.get('/file-route', (req, res) => {
  res.sendFile('/path/to/nonexistent/file');
});

// 全局错误处理中间件，必须放在所有路由之后！
app.use((err, req, res, next) => {
  // 区分ENOENT文件不存在错误
  if (err.code === 'ENOENT') {
    logger.error('File not found error', {
      clientRequest: req.originalUrl,
      missingFilePath: err.path,
      errorDetails: err.message,
      stack: err.stack
    });
    res.status(404).json({ status: 'error', message: 'Requested resource not found' });
  } else {
    // 处理其他类型的服务器错误
    logger.error('Unhandled server error', {
      error: err.message,
      stack: err.stack,
      requestUrl: req.originalUrl
    });
    res.status(500).json({ status: 'error', message: 'Internal server error' });
  }
});

关键原理说明 #

Express中，异步方法（比如sendFile）出错时，会自动把错误对象传递给next()函数，只要你定义了这个四参数的错误处理中间件，就能捕获到所有未被手动处理的错误。这样一来，不管哪个路由的sendFile出了ENOENT错误，都会被Winston记录下来，还能统一处理响应格式。

之前的try/catch无效，就是因为异步操作的错误不会在当前同步代码块中抛出，而是会进入事件循环的后续阶段，同步的try/catch根本抓不到它。

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