如何调试Express Generator构建的NodeJS API中的UnhandledPromiseRejectWarning？

运行本地API时收到如下警告：

UnhandledPromiseRejectionWarning: Error: write EPIPE at WriteWrap.afterWrite [as oncomplete] (net.js:835:14) (node:7028) > UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). (rejection id: 1)

该警告提示可能存在未正确添加catch()回调的JS Promise。我已检查API的控制器、模型及中间件，所有函数与Promise均正确返回，MongoDB守护进程运行正常，但API仅返回404状态码。请问无需TDD或单元测试的情况下，该如何调试此API？

我来给你几个不用写测试也能快速定位问题的调试思路：

• 全局捕获未处理的Promise拒绝：在项目入口文件（比如app.js或server.js）里加上全局监听，精准定位出错的Promise。代码如下：

  process.on('unhandledRejection', (reason, promise) => {
    console.error('未处理的Promise拒绝:', reason);
    console.error('对应的Promise调用栈:', reason.stack);
  });
  

  运行API后，就能看到具体是哪段代码抛出的错误，比默认警告信息详细得多。

• 逐步添加日志，追踪请求流转：

  • 先查路由层：在每个路由处理函数开头加console.log('进入路由:', req.method, req.url)，确认请求是否真的走到了预期路由——404很可能是路由匹配失败导致的，比如URL大小写、末尾斜杠或者路径写错了。
  • 再查中间件：在每个自定义中间件里加日志，确认请求是否依次通过所有中间件，有没有在某个中间件里提前返回却没处理后续逻辑。
  • 最后查控制器/模型：在所有Promise调用处临时加上.catch()打印错误，比如：

    User.findOne({ id: req.params.id })
      .then(user => { /* 业务逻辑 */ })
      .catch(err => {
        console.error('查询用户出错:', err);
        throw err;
      });
    

    这样能快速排查数据库操作里藏着的未捕获错误。

• 排查EPIPE错误的根源：
  EPIPE通常是尝试向已关闭的连接写数据导致的，比如客户端提前断开连接，但代码还在发送响应。可以在请求里加个连接关闭监听：

  req.on('close', () => {
    console.log('客户端已断开连接，终止请求处理');
  });
  

  另外也要检查有没有代码在异步操作完成前就提前结束了响应，导致后续Promise写响应时出错。

• 用Node.js自带调试工具断点追踪：
  启动API时用node --inspect server.js，然后打开Chrome的chrome://inspect页面连接调试进程。在可疑代码行设置断点，一步步追踪请求处理流程，看看到底是路由没匹配、Promise抛出未捕获错误，还是响应没正确发送。

• 核对请求细节：
  用Postman或curl发起请求时，仔细核对请求的HTTP方法、URL路径是否和路由配置完全一致——有时候不起眼的细节（比如POST写成了GET，路径多了个斜杠）都会导致404。另外还要检查静态文件中间件是否放在了API路由前面，导致请求被错误拦截。

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