You need to enable JavaScript to run this app. Puppeteer抛出「Session closed,页面大概率已关闭」错误的原因与修复方法
优惠活动
大模型
产品
解决方案
定价
更多

Puppeteer抛出「Session closed,页面大概率已关闭」错误的原因与修复方法

Puppeteer偶发会话关闭报错说明

偶发场景下页面运行状态不稳定,会触发如下报错:

UnhandledPromiseRejectionWarning: Error: Protocol error (Runtime.callFunctionOn): Session closed. Most likely the page has been closed.
    at CDPSession.send (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/Connection.js:195:35)
    at ExecutionContext._evaluateInternal (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/ExecutionContext.js:200:50)
    at ExecutionContext.evaluate (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/ExecutionContext.js:106:27)
    at DOMWorld.evaluate (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/DOMWorld.js:79:24)
    at emitUnhandledRejectionWarning (internal/process/promises.js:149:15)
    at processPromiseRejections (internal/process/promises.js:211:11)
    at processTicksAndRejections (internal/process/task_queues.js:98:32)
(node:38857) Error: Protocol error (Runtime.callFunctionOn): Session closed. Most likely the page has been closed.
    at CDPSession.send (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/Connection.js:195:35)
    at ExecutionContext._evaluateInternal (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/ExecutionContext.js:200:50)
    at ExecutionContext.evaluate (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/ExecutionContext.js:106:27)
    at DOMWorld.evaluate (/Users/lancepollard/start/lancejpollard/data/node_modules/puppeteer/lib/cjs/puppeteer/common/DOMWorld.js:79:24)
(node:38857) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

报错根本原因

  • 报错核心是Puppeteer基于CDP调试协议,向已经关闭的会话发送了Runtime.callFunctionOn请求,这类请求的作用是在当前页面的执行上下文里运行自定义JS代码。
  • 会话被关闭的直接诱因几乎都是关联的Page标签页被意外终止,偶发场景下的常见触发场景包括:
    • 页面自身逻辑触发跳转、弹窗关闭、JS崩溃,导致绑定的执行上下文被销毁
    • 运行环境内存不足,系统自动回收Chrome进程关联的标签页
    • 代码逻辑时序错乱:提前调用了page.close()或browser.close(),但仍有排队未执行的evaluate回调在发起协议请求
    • 页面加载超时触发了自动导航/关闭逻辑,和正在执行的JS求值操作产生竞态冲突
  • 附带的DEP0018弃用警告,本质是上述会话关闭产生的失败Promise没有被catch捕获,按照Node.js新版本规则,后续未处理的Promise rejection会直接导致进程以非零状态退出。

对应修复方案

  • 给所有页面发起的evaluate类操作补充异常捕获:不要忽略evaluate返回的Promise,针对会话关闭类错误做降级处理,避免异常冒泡到进程层,示例代码:
    page.evaluate(() => document.querySelector('#app')?.innerText)
      .catch(err => {
        // 识别会话关闭类可预期错误,直接返回跳过
        if (err.message.includes('Session closed')) return;
        // 其他未知异常正常抛出
        throw err;
      })
    
  • 页面操作前增加存活状态校验:在调用evaluate、click等页面交互方法前,先通过page.isClosed()判断当前标签页是否已经被关闭,若已关闭则直接跳过后续操作,不发起无效的CDP请求。
  • 优化操作时序控制:为页面导航、交互操作设置合理的超时阈值,避免无限制等待响应;对可能产生竞态的操作(比如连续触发的页面关闭和JS求值)做队列化处理,等前序操作完成后再执行关闭逻辑。
  • 调整Chrome启动稳定性参数:启动浏览器时追加--disable-dev-shm-usage、--no-zygote参数,降低低内存环境、容器化部署场景下Chrome标签页被系统意外回收的概率。
  • 增加进程层兜底监听:在Node.js入口补充process.on('unhandledRejection')逻辑,识别到会话关闭类可预期错误时静默处理,避免无意义的进程崩溃。

内容的提问来源于stack exchange,提问作者Lance Pollard

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 20:36:08