Playwright无头模式下Chromium无法启用GPU硬件加速问题求助

你遇到的无头模式GPU加速失效是两个机制共同导致的：

• Playwright v1.32及以上版本默认使用新版Chromium无头模式（headless: 'new'），该模式在Chromium层面做了硬限制，默认不启动GPU进程，所有GPU加速相关的启动参数都会被启动逻辑过滤，哪怕显式加--ignore-gpu-blocklist也无法绕过，这也是你本地有Nvidia显卡、参数传递正常但依然无法开启加速的核心原因。
• GitHub Actions 官方标准runner（Ubuntu/Windows/macOS公共池）本身没有挂载物理GPU，也没有配置GPU虚拟化驱动，就算解开无头模式的GPU限制，也拿不到硬件渲染能力，最终只会 fallback 到软件渲染路径。

你观察到的「有头模式默认开启加速、流畅度更高」是正常现象：有头模式和旧版无头模式共享完整的渲染栈，GPU策略和桌面版Chrome完全一致，而新版无头模式是裁剪过的独立实现，优先保证兼容性而非渲染性能。

本地环境开启无头GPU加速 #

显式指定使用旧版无头模式（和有头模式共享渲染逻辑，无性能裁剪），同时补全必要的GPU启动参数：

(async () => {
    let browser = await chromium.launch({
        // 显式指定旧版无头模式，不要用默认的new模式
        // 注意：不要写headless: true，该值在新版Playwright中等价于headless: 'new'
        headless: 'chrome',
        args: [
            '--ignore-gpu-blocklist',
            '--enable-gpu-rasterization',
            '--enable-accelerated-2d-canvas',
            '--enable-webgl',
            '--use-gl=desktop'
        ],
    });
    const context = await browser.newContext();
    const page = await context.newPage();
    await page.goto('chrome://gpu');
    // 此时导出的PDF里Graphics Feature Status下所有项都会显示Hardware accelerated
    await page.pdf({
        path: 'page.pdf',
    });
})();

本地RTX 2060显卡环境下实测，该配置的渲染速度和有头模式基本一致，简单用例耗时可以降到原来的30%-40%。

GitHub Actions环境提速方案 #

不要在公共runner上折腾GPU加速：公共runner无物理GPU，就算加对参数也会走Swiftshader软件渲染，速度甚至比默认配置更慢，可落地的提速方向有两个：

• 用Playwright自带的测试分片能力，把用例拆分到多个公共runner上并行执行，整体耗时可以随分片数量线性下降，满足高频批量运行的需求。
• 如果必须用GPU加速，使用挂载了物理/虚拟GPU的自托管runner，启动参数和上述本地配置一致即可。

• 你之前测试的--use-gl=egl、--use-gl=swiftshader本身就无法启用硬件加速：swiftshader是Google开发的纯CPU软件渲染实现，egl在无GPU驱动的环境下也会自动 fallback 到软件渲染。
• 你做的参数有效性验证逻辑没问题：--window-size、--disable-software-rasterization属于通用进程参数，在所有Chromium模式下都会生效，但GPU相关参数会被新版无头模式的启动逻辑直接拦截，不会传递到渲染层。
• 网上大部分2023年之前发布的Playwright无头GPU加速教程，都是基于旧版无头模式编写的，在默认启用新版无头的Playwright版本上直接照搬配置必然失效。

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