Node.js偶发UnhandledPromiseRejection，catch未捕获问题求助

1. Promise链断裂或嵌套Promise未被捕获
   哪怕移除了async/await，只要逻辑里存在嵌套Promise（比如在.then()中返回新Promise却没绑定catch），就可能出现第一次请求时嵌套Promise的拒绝被外层catch意外捕获，但第二次请求因全局状态残留（比如连接池、缓存状态），导致嵌套Promise的拒绝脱离原捕获链，变成未处理的拒绝。
2. 请求处理逻辑存在状态污染
   若请求处理中用到了全局变量或共享资源，第一次请求时错误处理逻辑正常生效，但第二次请求时状态未重置，导致错误处理函数失效或被覆盖，无法捕获Promise拒绝。
3. 错误响应后仍有未终止的异步逻辑
   捕获错误并返回404后，后续可能还有未终止的Promise操作在执行，这些操作的拒绝没被捕获。第一次请求时这类后续逻辑可能未触发，第二次因时序问题触发，引发未处理拒绝。

1. 确保所有Promise都被链式捕获 #

不管是顶层还是嵌套的Promise，都要保证每个Promise的拒绝都被.catch()覆盖，或在Promise链最末端添加统一捕获：

app.get('/api/resource', (req, res) => {
  fetchResource(req.params.id)
    .then(rawData => {
      // 嵌套Promise必须绑定catch，避免断裂
      return parseRawData(rawData).catch(parseErr => {
        throw new Error('数据解析失败: ' + parseErr.message);
      });
    })
    .then(formattedData => res.json(formattedData))
    .catch(err => {
      console.error('请求处理失败:', err);
      res.status(404).send('资源不存在');
    });
});

2. 清除全局状态污染 #

检查请求处理逻辑里的全局变量、共享资源（如数据库连接、缓存实例），确保每次请求使用独立实例，或在请求结束后重置状态。比如不要用全局dbConn，改用连接池的正确调用方式，每次请求获取独立连接。

3. 捕获全局Promise拒绝事件排查问题 #

注册全局事件避免应用崩溃，同时定位未被捕获的Promise：

process.on('unhandledRejection', (reason, promise) => {
  console.error('未处理的Promise拒绝:', reason.stack, '\n关联Promise:', promise);
});

process.on('rejectionHandled', (promise) => {
  console.error('延迟处理的Promise拒绝:', promise);
});

通过日志可以精准找到哪段Promise逻辑未被正确捕获。

4. 错误响应后终止后续逻辑 #

在catch块中明确终止后续异步操作，避免残留逻辑引发新的Promise拒绝：

.catch(err => {
  console.error(err);
  res.status(404).send('资源不存在');
  // 终止后续所有逻辑
  return;
});

5. 处理Promise.all的子Promise拒绝 #

如果用到Promise.all，要么给每个子Promise单独加catch，要么在Promise.all后绑定统一catch，避免单个子Promise拒绝导致整个链失控：

Promise.all([
  fetchDataA().catch(err => ({ err, source: 'A' })),
  fetchDataB().catch(err => ({ err, source: 'B' }))
])
.then(results => {
  // 检查每个结果是否包含错误
  const errors = results.filter(item => item.err);
  if (errors.length) {
    throw new Error('部分资源获取失败: ' + errors.map(e => e.source).join(','));
  }
  res.json(results);
})
.catch(err => {
  res.status(404).send('资源不存在');
});

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