Promise未处理拒绝异常：自定义Promise的Catch为何无法触发？

根据你描述的情况，我碰到过类似的坑，咱们一步步排查可能的原因和解决方案：

最可能的原因：Promise未正确接入主链 #

你提到这是一个更长Promise链的一部分，那首先要确认你的函数返回的Promise被正确return到主链中了。如果在调用这个函数时没有return，它会变成一个独立的"游离"Promise，既不会被自身的catch捕获（某些环境下可能出现这种异常），也不会被后续链的catch处理：

// ❌ 错误写法：没return，Promise脱离主链
someAsyncTask()
  .then(fe => {
    yourFunction(fe); // 这里没有return，导致Promise成为独立个体
  })
  .catch(e => console.log("主链catch没触发"));

// ✅ 正确写法：return让Promise接入主链
someAsyncTask()
  .then(fe => {
    return yourFunction(fe); // 将当前Promise加入主链
  })
  .catch(e => console.log("主链catch能捕获错误"));

排查步骤：一步步定位问题 #

1. 给错误逻辑加日志，确认执行流程 #

在reject前后和catch里添加日志，明确代码到底执行到了哪一步：

function (fe) {
  return new Promise(function (resolve, reject) {
    fe.getFile(fn, flags, resolve, function (e) {
      console.log("getFile返回的错误：", e); // 确认错误内容
      try {
        let errorToReject;
        if (e instanceof Error) {
          errorToReject = e;
          console.log("准备抛出原错误");
        } else {
          const strError = JSON.stringify(e);
          console.log("字符串化后的错误：", strError);
          errorToReject = new Error(strError);
        }
        reject(errorToReject);
      } catch (err) {
        console.log("reject逻辑自身出错：", err); // 排查JSON.stringify是否报错
        reject(err);
      }
    });
  }).catch(function(e){
    console.log("内部catch已触发：", e); // 确认catch是否执行
    return e; // 如果要让后续链的catch也捕获，需要return或throw
  });
}

2. 检查是否存在多次resolve/reject #

某些第三方API可能存在回调多次触发的bug（比如同时调用成功和错误回调），可以加状态锁确认：

function (fe) {
  return new Promise(function (resolve, reject) {
    let isHandled = false;
    fe.getFile(fn, flags, function (...args) {
      if (!isHandled) {
        isHandled = true;
        console.log("触发resolve：", args);
        resolve(...args);
      } else {
        console.log("已处理过，忽略重复resolve");
      }
    }, function (e) {
      if (!isHandled) {
        isHandled = true;
        console.log("触发reject：", e);
        reject(e instanceof Error ? e : new Error(JSON.stringify(e)));
      } else {
        console.log("已处理过，忽略重复reject");
      }
    });
  }).catch(function(e){
    console.log("内部catch触发：", e);
  });
}

3. 排查环境Promise兼容性 #

旧版本Node.js（v6以前）或部分旧浏览器的原生Promise实现存在bug，你可以尝试用第三方Promise库（比如bluebird）替代：

const Promise = require('bluebird'); // Node.js环境
// 浏览器环境可引入bluebird的CDN

function (fe) {
  return new Promise(function (resolve, reject) {
    fe.getFile(fn, flags, resolve, function (e) {
      reject(e instanceof Error ? e : new Error(JSON.stringify(e)));
    });
  }).catch(function(e){
    console.log(e);
  });
}

4. 监听全局未处理拒绝事件 #

添加全局监听器，获取更详细的错误上下文：

// Node.js环境
process.on('unhandledRejection', (reason, promise) => {
  console.log('未处理拒绝的Promise：', promise);
  console.log('拒绝原因：', reason);
});

// 浏览器环境
window.addEventListener('unhandledrejection', event => {
  console.log('未处理拒绝的Promise：', event.promise);
  console.log('拒绝原因：', event.reason);
});

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