为何单元测试出现未处理Promise拒绝警告？已调用reject仍报错

你遇到的核心问题是：调用reject后没有终止后续代码执行，导致同步错误触发未处理Promise拒绝警告。

具体原因 #

你的generateOnePDF函数内部通过new Promise实现逻辑，参数校验时调用了reject，但如果没有在reject后立即return终止执行，后续代码会继续运行。当传入非法参数（比如null）时，后续代码尝试解构null的属性、读取null的orderId，会触发同步的TypeError。

虽然Promise的executor会捕获同步错误，但因为Promise已经通过之前的reject进入了rejected状态，这个后续的同步错误会被JavaScript环境（比如Node.js）判定为未处理的Promise拒绝，从而在控制台抛出警告——即便你的单元测试已经捕获了最初的reject错误。

举个典型的错误代码示例：

async function generateOnePDF(payload) {
  return new Promise((resolve, reject) => {
    if (!payload) {
      reject(new Error('参数非法'));
      // 没有return，后续代码继续执行
    }
    const { orderId } = payload; // payload为null时，此处抛出TypeError
    // 其他PDF生成逻辑
    resolve(pdfResult);
  });
}

解决方法 #

在调用reject后立即添加return，终止executor内的后续代码执行：

async function generateOnePDF(payload) {
  return new Promise((resolve, reject) => {
    if (!payload) {
      reject(new Error('参数非法'));
      return; // 终止后续代码运行
    }
    const { orderId } = payload; // 仅在参数合法时执行
    // 其他PDF生成逻辑
    resolve(pdfResult);
  });
}

额外建议 #

如果你的参数校验逻辑比较复杂，可以提前把校验逻辑移到Promise外部（因为async函数会自动将同步错误转为rejected Promise），这样代码更清晰，也能避免这类问题：

async function generateOnePDF(payload) {
  // 参数校验移到Promise外部
  if (!payload) {
    throw new Error('参数非法');
  }
  const { orderId } = payload;
  if (!orderId) {
    throw new Error('缺少orderId');
  }

  return new Promise((resolve, reject) => {
    // 仅处理异步PDF生成逻辑
    // ...
    resolve(pdfResult);
  });
}

这样，非法参数触发的同步错误会被async函数自动包装为rejected Promise，既不需要手动调用reject，也能避免后续代码执行导致的额外错误。

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