Gitpod中运行.NET Playwright测试时BROWSER环境变量异常问题

错误核心原因是Gitpod默认设置的BROWSER环境变量值为/.supervisor/browser.sh，不符合Playwright要求的浏览器名称（仅支持chromium、firefox、webkit）。以下是几种可行的解决方法：

方法1：在测试代码中提前修正变量 #

在测试类的全局初始化方法中，清除或覆盖BROWSER变量，确保在Playwright初始化前生效：

[OneTimeSetUp]
public void GlobalSetup()
{
    // 清除错误的环境变量，使用Playwright默认浏览器
    Environment.SetEnvironmentVariable("BROWSER", null);
    
    // 也可以直接指定浏览器，比如：
    // Environment.SetEnvironmentVariable("BROWSER", "chromium");
}

NUnit的OneTimeSetUp会在测试类所有测试执行前运行，优先级高于Playwright的初始化逻辑。

方法2：修改Gitpod工作区配置 #

在项目根目录的.gitpod.yml中直接配置正确的BROWSER变量，从工作区层面解决问题：

tasks:
  - name: Prepare Playwright
    env:
      BROWSER: chromium
    command: |
      dotnet tool install --global Microsoft.Playwright.CLI
      playwright install --with-deps

这样工作区启动时就会覆盖默认的BROWSER变量值。

方法3：运行测试时临时覆盖变量 #

执行测试命令时，直接在命令行指定正确的BROWSER变量：

BROWSER=chromium dotnet test

这种方式仅对当前测试命令生效，适合临时调试场景。

为什么手动设置没生效？ #

如果之前用System.Environment.SetEnvironmentVariable没解决，大概率是因为调用时机太晚——Playwright的测试适配器会在测试类初始化阶段就读取环境变量，此时你的代码修改还没生效，所以必须把变量修改放在更早的初始化步骤中。

内容的提问来源于stack exchange，提问作者Theophilus Timothy Ruben