Puppeteer截图报Target closed协议错误问题咨询

数据老陈

2026-8-27

报错核心原因

Target closed报错本质是Chromium渲染进程意外崩溃/被强制关闭，和你代码逻辑相关的触发点有4个：

无效启动参数配置
你加的--shm-size=3gb是Docker容器运行参数，不是Chromium支持的启动flag，直接写在puppeteer的args列表里完全不会生效。目标站点是无限加载的长列表商品页，两次全页截图+双视口切换会加载数百张商品图，Chromium默认使用的/dev/shm共享内存空间仅64MB，内存溢出直接导致渲染进程被系统杀掉，这是崩溃的核心诱因。你虽然加了--disable-dev-shm-usage，但低版本Puppeteer或者容器环境下权限不足时，这个参数可能无法正常生效。
滚动逻辑与Puppeteer原生全页截图冲突
你自定义的autoScroll逻辑用固定100次计数作为终止条件，步长389px、间隔50ms，最多执行5秒就会终止，根本无法覆盖动态加载的长列表内容；同时你开启了screenshot的fullPage: true配置，Puppeteer执行全页截图时会自带滚动逻辑触发懒加载，和你提前执行的滚动操作重复触发页面重排、资源加载，进一步推高内存占用。
双视口切换导致内存翻倍
你在同一个页面上下文里先切390px移动端视口截全页，再切1920px桌面端视口截全页，切换视口时页面会重新加载所有响应式资源、重排整个DOM树，前一个视口加载的资源不会被立即回收，内存占用直接翻倍，很容易触达内存上限。
缺少进程崩溃捕获逻辑
你用的Cluster.CONCURRENCY_CONTEXT模式没有监听浏览器/页面的断开事件，渲染进程崩溃时你拿不到具体的崩溃原因（比如内存溢出SIGSEGV信号、页面跳转、JS阻塞导致进程无响应被杀），只会拿到CDP连接断开的通用报错。

另外你代码里有个不影响运行的笔误：调用Screenshot时传入了screenshotPaths参数，但函数定义没有接收该参数，按需调整即可。

修复方案

清理无效启动参数：把--shm-size=3gb从puppeteer的args里删掉，如果你是在Docker环境运行，把这个参数配置在docker run/compose的shm-size配置项里；物理机运行可以额外加--disable-gpu、--disable-software-rasterizer降低渲染内存占用。
去掉冗余的预滚动逻辑：fullPage: true截图本身会自动处理滚动触发懒加载，如果要提前等图片加载，不用自己写setInterval滚动，直接在截图前执行以下逻辑等待图片加载完成即可：

await page.evaluate(() => {
  return Promise.all(Array.from(document.images).map(img => {
    if (img.complete) return;
    return new Promise(resolve => {
      img.addEventListener('load', resolve);
      img.addEventListener('error', resolve);
    });
  }));
});

拆分双端截图逻辑：不要在同一个页面实例里切换视口截两次图，截完移动端之后关闭当前页面，新开页面加载目标地址再切桌面端视口截图，避免同一个上下文内存累积。
加崩溃监听定位问题：在cluster启动后加断开事件日志，方便确认具体崩溃原因：

cluster.on('browserReady', (browser) => {
  browser.on('disconnected', () => {
    console.log('浏览器进程断开，退出码：', browser.process()?.exitCode);
  });
});

降低单页内存压力：全页截图时给page设置page.setDefaultNavigationTimeout(120000)延长超时，同时把page.goto的waitUntil改成domcontentloaded，不要等networkidle2——长列表页持续有异步请求不会达到真正的空闲状态，硬等反而会累积未完成请求占用内存。

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