Puppeteer-cluster设headless:true仍启动空白Chrome页，如何阻止？

可能的原因及解决方案 #

1. 切换到新版无头模式 #

从Puppeteer v19版本开始，headless: true对应旧版无头模式，在部分桌面环境下仍可能触发空白窗口显示。官方推荐使用更彻底的新版无窗口模式，修改配置中的headless参数：

const initCluster = async () => {
    process.setMaxListeners(Infinity);
    return await Cluster.launch({
        concurrency: Cluster.CONCURRENCY_CONTEXT,
        maxConcurrency: 4,
        timeout: 10000,
        puppeteerOptions: {
            headless: "new", // 替换为新版无头模式
            args: [
                '--no-sandbox',
                '--disable-notifications',
                '--disable-extensions',
                '--disable-gpu',
                '--disable-setuid-sandbox'
            ]
        }
    });
};

2. 排查任务函数中的额外浏览器实例 #

检查你的集群任务处理代码，确保没有在任务内单独调用puppeteer.launch()——这种情况会额外启动独立的浏览器窗口，所有浏览器资源都应该由Cluster统一管理，任务中只使用Cluster提供的page或context对象。

3. 验证并发模式的兼容性 #

你当前使用的CONCURRENCY_CONTEXT模式是共享单个浏览器实例、为每个任务创建独立上下文，理论上不会启动多窗口。如果问题仍存在，可以临时切换到CONCURRENCY_PAGE模式测试，确认是否是模式适配问题：

concurrency: Cluster.CONCURRENCY_PAGE,

部署后的表现 #

如果将应用部署到无桌面环境的服务器（如Linux服务器），即使本地开发时存在空白窗口问题，部署后也不会显示任何窗口——服务器没有图形界面（X11/Wayland），无头浏览器会在后台静默运行，不会弹出可视化窗口。

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