Microsoft.Playwright.DotNet并行测试中的常见问题与解决方案

问题背景

在使用Microsoft.Playwright.DotNet进行自动化测试时，开发者在并行执行测试用例时可能会遇到两种典型错误：

1. 集合修改异常：System.InvalidOperationException: Collection was modified; enumeration operation may not execute.
2. 目标关闭异常：Microsoft.Playwright.TargetClosedException: Target page, context or browser has been closed

这些错误通常发生在多个测试用例并行执行时，特别是在同一个测试类中包含多个测试方法的情况下。

错误原因分析

集合修改异常

这个异常发生在测试框架尝试清理资源时，具体是在BrowserTearDown方法中。当多个测试线程同时尝试修改共享的浏览器实例集合时，就会触发这个并发修改异常。这反映了.NET集合在枚举过程中不允许修改的基本线程安全问题。

目标关闭异常

这个异常表明测试代码尝试操作一个已经被关闭的页面或浏览器上下文。在并行测试环境中，当一个测试完成并关闭其资源时，另一个测试可能仍在尝试使用这些资源，导致操作失败。

解决方案

正确的并行测试配置

Microsoft.Playwright.DotNet对并行测试的支持有其特定要求。关键是要正确配置NUnit的并行范围：

[Parallelizable(ParallelScope.Self)]  // 正确的配置
public class Tests : PageTest
{
    // 测试方法
}

而不是使用：

[Parallelizable(ParallelScope.All)]  // 可能导致问题的配置

ParallelScope.Self确保每个测试类实例独立运行，而不会与其他测试实例共享资源，从而避免了资源竞争问题。

最佳实践建议

1. 隔离测试资源：确保每个测试用例拥有独立的页面实例，避免共享状态。

2. 合理设计测试类：

   • 将相关测试逻辑分组到不同的测试类中
   • 每个测试类应专注于一个特定的功能区域

3. 资源管理：

   • 使用PageTest基类提供的生命周期管理
   • 避免手动管理浏览器和页面实例

4. 错误处理：

   • 为关键操作添加适当的错误处理和重试机制
   • 考虑实现自定义的截图和日志记录功能，以便于调试

深入理解

Playwright的并行测试机制依赖于正确的测试框架集成。NUnit的ParallelScope.Self设置确保了：

• 每个测试类实例化时获得独立的浏览器上下文
• 测试执行过程中不会与其他测试产生资源冲突
• 清理操作可以安全执行，不会干扰其他正在运行的测试

相比之下，ParallelScope.All会导致测试方法级别的并行化，这可能超出Playwright当前的支持范围，特别是在共享浏览器实例的情况下。

结论

通过正确配置测试并行化范围和遵循资源隔离原则，可以有效地避免Microsoft.Playwright.DotNet中的并行测试问题。理解测试框架与Playwright集成的内部机制对于构建稳定可靠的自动化测试套件至关重要。开发者应当根据实际测试需求，在测试隔离性和执行效率之间找到平衡点。