Puppeteer未捕获异常处理及浏览器无法关闭问题排查

1. 为何uncaughtException处理器中浏览器无法关闭？ #

• Node.js 不等待异步处理完成：你的uncaughtException处理函数是async类型，但Node.js触发该事件时，不会等待await后的异步操作完成，会直接执行后续的process.exit(1)，导致browser.close()还未完成，进程就已退出，浏览器实例残留。
• 断网后的通信障碍：运营商强制断网会中断Puppeteer与浏览器实例的IPC通信，此时browser.close()可能因无法连接到浏览器进程而卡住或失败，无法完成正常关闭流程。
• 异步错误被静默吞掉：async函数在uncaughtException处理程序中抛出的错误不会被Node.js捕获，导致关闭失败的情况无法被察觉，也无法触发兜底逻辑。

2. 是否有更优方法确保未处理错误发生时浏览器正常关闭？ #

有几种更可靠的方案：

• 同时监听两类未处理错误：Puppeteer多数操作是异步的，很多未处理错误会触发unhandledRejection而非uncaughtException，需同时监听这两个事件。
• 用Promise链式调用替代async/await：避免在事件处理函数中使用async，改用Promise链式调用确保关闭操作完成后再退出进程。
• 添加超时与强制兜底：如果browser.close()超时或失败，直接强制杀死浏览器进程，避免残留。
• 提前捕获核心逻辑错误：在Puppeteer核心操作外层包裹try-catch，提前处理大部分错误，减少未处理错误触发的概率。

3. 是否存在process在browser.close()的Promise完成前就退出的情况？ #

是的，这种情况非常普遍。当uncaughtException处理函数为async时，Node.js不会等待await browser.close()的Promise完成，会立即执行process.exit(1)，导致浏览器关闭流程被中断，进程残留。

修复方案示例 #

1. 修正错误监听与清理逻辑 #

// 确保browser变量在全局作用域可访问
let browser;

// 监听未捕获的同步异常
process.on("uncaughtException", (err) => {
  console.log(`ALERT! Uncaught exception: ${err}\nStack trace: ${err.stack}`);
  cleanupBrowser(true);
});

// 监听未处理的异步Promise拒绝
process.on("unhandledRejection", (reason, promise) => {
  console.log(`ALERT! Unhandled rejection at: ${promise}, reason: ${reason}`);
  cleanupBrowser(true);
});

// 监听系统终止信号（如服务部署时的SIGTERM）
process.on("SIGTERM", () => {
  console.log("Received SIGTERM, closing browser...");
  cleanupBrowser(false);
});

// 统一的浏览器清理函数
function cleanupBrowser(exitAfter) {
  if (!browser) {
    exitAfter && process.exit(1);
    return;
  }

  // 带超时的关闭逻辑，避免因通信中断卡住
  const closePromise = Promise.race([
    browser.close(),
    new Promise((_, reject) => setTimeout(() => reject(new Error("Close timeout")), 5000))
  ]);

  closePromise
    .then(() => {
      console.log("Browser closed successfully");
      exitAfter && process.exit(0);
    })
    .catch((closeErr) => {
      console.error("Failed to close browser normally:", closeErr);
      // 强制杀死浏览器进程兜底
      if (browser.process()) {
        browser.process().kill("SIGKILL");
        console.log("Browser process killed forcefully");
      }
      exitAfter && process.exit(1);
    });
}

2. 启动浏览器时记录进程信息（可选） #

保存浏览器进程实例，方便后续强制杀死：

const puppeteer = require("puppeteer");

async function startBrowser() {
  browser = await puppeteer.launch();
  // 保存进程实例到全局
  global.browserProcess = browser.process();
  return browser;
}

3. 核心逻辑添加错误捕获 #

在Puppeteer操作外层包裹try-catch，提前处理错误：

async function runTask() {
  try {
    const page = await browser.newPage();
    await page.goto("https://example.com");
    // ...执行你的业务操作
    await page.close();
  } catch (err) {
    console.error("Task failed:", err);
    await cleanupBrowser(false);
    // 可选择重启任务或执行其他兜底逻辑
  }
}

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