Node.js 怎么用 process.on("warning") 捕获和排查废弃 API 警告？

Question

仓乃文 · Accepted Answer

升级 Node.js 版本或依赖后，废弃 API 的警告只打印到 stderr 不留记录，生产环境容易错过。监听 process 的 warning 事件可以捕获所有警告并上报，提前发现即将移除的 API 避免升级时突然崩溃。

捕获所有警告：
```javascript
process.on("warning", (warning) => {
  console.error({
    name: warning.name,       // DeprecationWarning
    message: warning.message,  // 具体废弃信息
    stack: warning.stack       // 调用栈
  });
  // 上报到监控系统
  monitor.report("node_warning", warning);
});
```

分类处理：
```javascript
process.on("warning", (warning) => {
  if (warning.name === "DeprecationWarning") {
    // 废弃 API 警告，需要修复
    logger.warn("废弃 API:", warning.message);
    logger.warn("调用栈:", warning.stack);
  } else if (warning.name === "ExperimentalWarning") {
    // 实验性功能警告，评估是否使用
    logger.info("实验性功能:", warning.message);
  }
});
```

补充说明：
- --throw-deprecation 将废弃警告转为抛出异常，测试时使用
- --trace-deprecation 打印废弃 API 的完整调用栈
- --trace-warnings 打印所有警告的调用栈
- 生产环境建议将 warning 事件上报到日志系统
- 常见废弃：util._extend、Buffer() 构造函数、旧版 URL API