Playwright自托管Git工作流执行失败：浏览器安装报错

AI 小北

2026-6-25

解决自托管 Runner 上 Playwright 浏览器安装失败问题

问题分析

自托管 Runner 的操作系统不在 Playwright 官方支持列表中，回退安装依赖时因权限或系统适配问题导致浏览器安装失败。

指定兼容系统环境变量
在安装 Playwright 的步骤中添加环境变量，强制匹配兼容的系统类型，示例如下：
```
- name: Install Playwright Browsers
  env:
    PLAYWRIGHT_OS: ubuntu20.04-x64
  run: npx playwright install --with-deps
```
可根据自托管机器实际系统替换ubuntu20.04-x64为官方兼容值（如ubuntu22.04-x64、debian11-x64等）。
配置 Runner 用户免密 sudo
确保自托管机器上的 Runner 执行用户拥有免密 sudo 权限：
1. 执行sudo visudo编辑 sudoers 文件
2. 添加一行：runner-user ALL=(ALL) NOPASSWD: ALL（替换runner-user为实际运行用户）
手动预安装系统依赖
直接在自托管机器上提前完成依赖安装，避免工作流中权限问题：
```
sudo npx playwright install-deps ubuntu20.04-x64
```
之后修改工作流步骤，仅安装浏览器：
```
- name: Install Playwright Browsers
  run: npx playwright install
```
更换为官方支持的系统
检查自托管机器的操作系统版本，优先使用 Playwright 官方明确支持的系统版本，从根源避免兼容问题。