Node.js日志中异步错误怎么处理

在Node.js里，异步错误处理一直是开发者绕不开的实操难题。写出来的代码跑着跑着突然崩了，日志里又找不到明确线索——多半是异步环节出了岔子。下面梳理几个实战中高频使用的处理手段，从经典回调到现代Promise，按需选用即可。

1. 回调函数里的“错误优先”约定
   这是Node.js早期最通用的模式。简单说，回调的第一个参数固定留给错误对象，如果没有错误，第一个参数就是null或undefined。这种设计让人一眼就能定位异常，代码写起来也直截了当：

   fs.readFile('file.txt', 'utf-8', (err, data) => {
     if (err) {
       console.error('读取文件时发生错误:', err);
       return;
     }
     console.log('文件内容:', data);
   });

   踩坑提醒：千万别忘了检查err，否则后续代码可能在错误状态下继续执行，埋下难以追踪的bug。

2. 事件监听器——流式场景的标配
   如果你用Stream或者EventEmitter风格的API，错误处理就得靠事件绑定。给对象挂一个on('error')监听，就像给程序装了个安全气囊：

   const fs = require('fs');
   const readStream = fs.createReadStream('file.txt');
   readStream.on('error', (err) => {
     console.error('读取文件时发生错误:', err);
   });
   readStream.on('data', (chunk) => {
     console.log('文件内容:', chunk);
   });

   关键点：error事件必须提前注册，否则一旦错误触发而没被捕获，整个进程可能会直接退出。

3. Promise + async/await——更优雅的错误捕获
   现代Node.js开发几乎离不开Promise。使用fs.promises或包装后的异步函数，配合.catch()或者try/catch，写法简洁许多，而且错误处理逻辑可以精确聚焦：

   const fs = require('fs').promises;
   
   async function readFileAsync() {
     try {
       const data = await fs.readFile('file.txt', 'utf-8');
       console.log('文件内容:', data);
     } catch (err) {
       console.error('读取文件时发生错误:', err);
     }
   }
   readFileAsync();

   这种方式最大的好处是——代码看起来像同步的，逻辑清晰，排查问题时一目了然。

4. 全局兜底：uncaughtException
   万一有错误在代码里没有被任何catch或on('error')捕获，Node.js会抛出uncaughtException事件。可以用它来做最后的日志记录，但得记住：这玩意儿是最后一道防线，不是常规处理手段。用了它，进程状态可能已不可靠，最佳实践是打印错误后立即process.exit(1)，重启新进程：

   process.on('uncaughtException', (err) => {
     console.error('发生未捕获的错误:', err);
     process.exit(1); // 终止进程
   });

   生产环境中，更推荐搭配PM2、Docker等进程管理工具实现自动重启，而不是依赖全局监听来“救火”。

说到底，Node.js异步错误没有银弹。选哪种方式，取决于你项目的技术栈和团队的编码习惯。但有一条原则始终不变：所有异步操作都必须有对应的错误处理逻辑——丢了这一环，稳如泰山的应用也会变成定时冲击波。