Playwright Python Windows 下 headful Chromium 崩溃排查经验分享

最近在使用 Playwright Python 做 UI 自动化时，遇到了一个有趣的问题：

在 Windows 上，headful 模式（有界面）启动 Chromium 时，总是立刻关闭报错，而无头模式（headless=True）却完全正常。

我总结了一下排查过程和原理，分享给大家：

1️⃣ 问题现象

代码示例：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=False)  # headful 模式
    page = browser.new_page()
    page.goto("https://playwright.dev/python/docs/api/class-page")
    print(page.title())
    browser.close()

运行结果：

playwright._impl._errors.TargetClosedError: BrowserType.launch: Target page, context or browser has been closed

特点：

• headful 模式报 TargetClosedError

• headless 模式一切正常

• Chromium 可执行文件单独双击可以正常打开

• 问题出现在 Playwright 的启动参数和环境兼容上

2️⃣ 原理分析

Playwright 启动 Chromium 的过程：

1. 找到浏览器可执行文件

2. 创建临时用户数据目录

3. 通过命令行启动 Chromium，并传入大量自动化优化参数

4. 建立 CDP（Chrome DevTools Protocol）通信

5. 创建浏览器上下文和标签页

6. 执行自动化操作

7. 关闭浏览器，清理临时目录

headful 模式 vs headless 模式：

模式	特点
headless=True	无 UI 窗口，不依赖显卡驱动 → 最稳
headful=False	创建可见窗口，依赖显卡和 Windows 用户会话 → 容易 crash

3️⃣ 关键因素

经过排查，headful crash 与以下参数最相关：

• headless：headful 模式容易触发显卡 / 系统兼容问题

• chromium_sandbox：Chromium 沙箱状态，Windows 下开启或关闭都会影响稳定性

• args：额外命令行参数，如果和默认参数冲突也可能导致 crash

其他参数（下载路径、慢速操作、信号处理、Firefox 偏好）对 crash 影响较小。

4️⃣ Windows 上稳定启动策略

最稳模板：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(
        headless=False,            # headful
        chromium_sandbox=True,     # 开启沙箱在 Windows 上稳定
        args=[
            "--disable-infobars",
            "--disable-extensions",
        ]
    )
    page = browser.new_page()
    page.goto("https://playwright.dev/python/docs/api/class-page")
    print(page.title())
    browser.close()

小贴士：

• 先尽量用 headless=True 自动化测试，最稳定

• headful 调试时开启 chromium_sandbox=True

• 避免随意加 ignore_default_args=True 或复杂 args

6️⃣ 总结

• Playwright headful crash 常见于 Windows，主要是 沙箱 + GPU + 命令行参数冲突

• headless 模式几乎不会出问题

• Windows 上，开启沙箱 + 保持默认参数 是最稳的组合

• 理解 launch 参数和启动流程可以快速排查自动化环境问题

附Playwright chromium.launch() 的完整参数定义

核心参数分析

参数	作用	Windows headful 影响
executable_path	指定 Chromium / Chrome 可执行文件路径	如果你指定非 Playwright 内置 Chromium，可能版本不匹配或命令行参数不兼容 → crash
channel	指定浏览器通道（chrome, msedge 等）	可能会选择不同的浏览器特性，headful 稳定性可能不同
args	额外命令行参数	可以传 --disable-gpu, --no-sandbox 等；参数冲突可能导致 headful crash
ignore_default_args	是否忽略默认参数	默认参数里有很多自动化优化参数，忽略它们可能影响稳定性
handle_sigint/term/hup	Ctrl+C / SIGTERM 信号处理	对 crash 没影响，主要是 Playwright 进程退出处理
timeout	启动浏览器超时	超短可能导致 TargetClosedError，但你没设置，默认 30s 足够
env	浏览器环境变量	可以用来调试日志，例如 PLAYWRIGHT_DEBUG=1
headless	是否无头	headful crash 的核心因素之一
proxy	网络代理	可能影响网络相关自动化，但不是 crash 原因
downloads_path	下载目录	对 headful crash 无关
slow_mo	操作延迟	对 crash 无关
traces_dir	追踪存储目录	对 crash 无关
chromium_sandbox	沙箱启用/禁用	对 Windows headful crash 高度相关；不同环境沙箱状态不同，可能是你开启后就能稳定运行的关键
firefox_user_prefs	Firefox 用户偏好	不影响 Chromium