微软Playwright项目中Chromium浏览器在Jenkins环境下的崩溃问题分析与解决方案

问题背景

在使用微软Playwright测试框架时，部分用户在Jenkins环境中遇到了Chromium浏览器崩溃的问题。具体表现为当Playwright配置中明确指定使用Chromium浏览器(channel = chromium)时，浏览器启动失败并抛出"Target page, context or browser has been closed"错误。

错误现象

从日志中可以观察到以下关键错误信息：

1. chrome_crashpad_handler报错"--database is required"
2. socket连接被重置的错误
3. 浏览器进程异常终止(SIGTRAP信号)

环境分析

该问题主要出现在以下环境中：

• Jenkins运行在CentOS 7系统上
• 使用Playwright官方Docker镜像(mcr.microsoft.com/playwright:v1.51.0-noble)
• 明确配置使用Chromium浏览器(channel = chromium)

根本原因

经过深入分析，这个问题与Linux系统的XDG基础目录规范有关。Chromium浏览器需要特定的目录来存储临时数据和缓存，而在某些CI/CD环境(特别是容器化的Jenkins环境)中，这些目录可能没有正确配置或不可写。

解决方案

方法一：设置环境变量(推荐)

在容器或运行环境中添加以下环境变量：

XDG_CONFIG_HOME=/tmp/.chromium
XDG_CACHE_HOME=/tmp/.chromium

这两个变量分别指定了Chromium的配置目录和缓存目录位置，将其指向/tmp目录可以确保有足够的写入权限。

方法二：调整启动参数

虽然最初尝试添加--disable-gpu和--disable-dev-shm-usage参数没有直接解决问题，但在某些环境下这些参数仍然有助于提高稳定性：

use: {
  launchOptions: {
    args: ['--disable-gpu', '--disable-dev-shm-usage']
  }
}

方法三：更换基础环境

如果条件允许，可以考虑将Jenkins运行环境从CentOS 7迁移到更新的Linux发行版，因为CentOS 7已经逐渐被淘汰，可能缺乏对新技术的完善支持。

技术原理

Chromium浏览器在Linux系统中依赖XDG基础目录规范来定位用户特定的数据和配置文件。当这些目录不可访问时，浏览器无法正确初始化其崩溃报告系统(crashpad)，导致启动失败。通过显式指定这些目录的位置，可以确保浏览器有足够的权限创建必要的临时文件。

最佳实践建议

1. 在容器化环境中运行Playwright测试时，始终确保/tmp目录可写
2. 对于关键CI/CD流水线，考虑使用专门的测试环境而非共享的Jenkins节点
3. 定期更新Playwright版本以获取最新的稳定性修复
4. 在复杂环境中，优先使用环境变量方案而非仅依赖启动参数

总结