Puppeteer 在 Windows 系统下自动弹出浏览器窗口的问题分析

问题现象

近期 Puppeteer 用户报告了一个在 Windows 系统下的异常行为：当使用 puppeteer.launch() 方法启动浏览器时，即使没有明确配置显示浏览器窗口，系统也会自动弹出一个可见的浏览器窗口。这个问题从 Puppeteer v23.1.1 版本开始出现，影响了包括 headless 模式在内的多种使用场景。

问题根源

经过 Puppeteer 维护团队的分析，确认这个问题源于 Chromium M128 版本中的一个 Windows 平台特定 bug。该问题在 Chromium 的 issue 跟踪系统中已有记录，属于上游 Chromium 的问题而非 Puppeteer 本身的缺陷。

影响范围

该问题主要影响以下环境组合：

• Windows 操作系统
• Puppeteer v23.1.1 及以上版本
• 基于 Chromium M128 或更高版本的浏览器

值得注意的是，即使用户明确设置了 headless 模式，或者使用了较旧版本的 Puppeteer（如 v13.5.2）配合新版 Chromium 浏览器，同样可能遇到此问题。

临时解决方案

在官方修复发布前，用户可以采用以下几种临时解决方案：

1. 使用旧版 headless 模式： 通过添加 --headless=old 参数强制使用旧版 headless 实现

2. 窗口位置偏移法： 添加 --window-position=-10000,-10000 参数将窗口移出可视区域

3. 降级浏览器版本： 使用 Chromium M127 或更早版本的浏览器可避免此问题

官方修复

Puppeteer 团队已在 v23.6.0 版本中解决了这个问题。用户升级到此版本后，浏览器窗口将不再意外弹出，headless 模式也能正常工作。

技术建议

对于需要稳定运行 Puppeteer 的生产环境，建议：

1. 保持 Puppeteer 和浏览器版本的同步更新
2. 在 CI/CD 环境中明确指定浏览器版本
3. 对于关键业务场景，考虑锁定已知稳定的版本组合

这个问题再次提醒我们，在使用自动化浏览器工具时，浏览器引擎版本与驱动库版本的兼容性至关重要。开发者应当关注官方发布说明，及时获取已知问题的修复信息。