Selenium 4 EdgeDriver在xUnit中无法并行运行测试的原因排查

核心原因：xUnit的实例隔离与生命周期特性 #

xUnit默认每个测试方法都会创建一个全新的测试类实例，和控制台程序的单实例运行逻辑完全不同，这是导致驱动关联问题的核心：

• 若你把EdgeDriver实例存在测试类的实例字段里，每个测试方法的类实例都是独立的，静态类的驱动服务如果没做隔离，就会出现句柄关联混乱。
• xUnit默认开启测试集合并行执行，多个测试方法同时创建驱动时，进程间的资源竞争会导致浏览器句柄无法正确绑定。

可能的具体问题点 #

• 静态类状态污染：如果你的静态驱动服务类缓存了EdgeDriverService或EdgeOptions实例（比如全局复用同一个服务），第二个驱动启动时会复用已有服务，导致浏览器句柄被覆盖或无法创建新窗口。
• 实例级驱动未隔离：测试基类中的驱动是实例字段，但xUnit每次测试都新建基类实例，若驱动初始化逻辑依赖全局状态，会导致实例关联失败。
• 并行测试资源冲突：并行执行时，多个EdgeDriver进程共享系统资源，浏览器进程的句柄无法被正确映射到对应的驱动实例。

解决办法 #

1. 控制xUnit的实例与并行行为 #

• 使用[Collection]特性将需要共享上下文的测试归为同一集合，xUnit会为该集合的所有测试使用同一个类实例：

  [Collection("EdgeTests")]
  public class EdgeTests : EdgeTestBase
  {
      // 测试方法
  }
  
  // 定义非并行集合（可选）
  [CollectionDefinition("EdgeTests", DisableParallelization = true)]
  public class EdgeTestCollection : ICollectionFixture<EdgeTestBase> { }
  

• 全局禁用并行：在项目根目录创建xunit.runner.json，添加配置：

  {
      "parallelizeTestCollections": false
  }
  

2. 重构静态驱动工厂类，避免状态污染 #

不要让静态类持有全局实例，改为每次创建驱动时生成全新的服务和选项：

public static class EdgeDriverFactory
{
    public static EdgeDriver CreateEdgeDriver()
    {
        // 每次创建全新的服务实例
        var service = EdgeDriverService.CreateDefaultService();
        service.SuppressInitialDiagnosticInformation = true;
        
        // 为每个驱动实例分配独立的用户数据目录，避免冲突
        var tempUserDataDir = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString());
        var options = new EdgeOptions();
        options.AddArgument($"--user-data-dir={tempUserDataDir}");
        options.AddArgument("--no-sandbox"); // 解决部分环境下的权限问题

        return new EdgeDriver(service, options);
    }
}

3. 显式管理驱动生命周期 #

在测试基类中实现IDisposable，确保每个驱动实例在测试结束后被正确销毁，避免句柄残留：

public class EdgeTestBase : IDisposable
{
    protected List<EdgeDriver> Drivers { get; } = new List<EdgeDriver>();

    protected EdgeDriver CreateNewDriver()
    {
        var driver = EdgeDriverFactory.CreateEdgeDriver();
        Drivers.Add(driver);
        return driver;
    }

    public void Dispose()
    {
        foreach (var driver in Drivers)
        {
            try
            {
                driver.Quit();
            }
            catch { }
            driver.Dispose();
        }
    }
}

4. 单测试方法内创建多个驱动的正确方式 #

如果需要在单个测试方法中启动两个Edge窗口，直接在方法内创建并显式管理：

[Fact]
public void TestTwoEdgeWindows()
{
    using var driver1 = EdgeDriverFactory.CreateEdgeDriver();
    using var driver2 = EdgeDriverFactory.CreateEdgeDriver();

    driver1.Navigate().GoToUrl("https://example.com");
    driver2.Navigate().GoToUrl("https://google.com");

    // 执行断言或操作
    Assert.Equal("Example Domain", driver1.Title);
    Assert.Equal("Google", driver2.Title);
}

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