解决Playwright-Go并行测试中的"text file busy"错误

在基于Playwright-Go进行自动化测试时，开发人员可能会遇到一个典型的并发问题：当使用-p2参数运行并行测试时，系统报错"could not install driver: could not create driver: open /github/home/.cache/ms-playwright-go/1.44.1/node: text file busy"。这个错误看似简单，但实际上揭示了Go语言与Playwright集成时的一些底层机制问题。

错误根源分析

该错误的核心在于文件锁竞争。当多个Go测试例程尝试同时访问和修改Playwright的驱动缓存文件时，Linux系统会阻止这种并发操作，抛出"text file busy"错误。这主要是因为：

1. Playwright-Go在初始化时会检查并安装必要的浏览器驱动
2. 安装过程涉及对缓存目录的读写操作
3. 并行测试导致多个进程同时尝试修改同一文件

解决方案与实践

方案一：串行化驱动安装

最直接的解决方案是在并行测试前确保驱动已经安装完毕。修改测试代码，将playwright.Install()移出测试函数，放在测试套件的初始化阶段：

func TestMain(m *testing.M) {
    // 预先安装驱动
    if err := playwright.Install(); err != nil {
        log.Fatalf("无法安装Playwright驱动: %v", err)
    }
    os.Exit(m.Run())
}

方案二：使用同步机制

如果必须在测试函数内部安装驱动，可以使用sync.Once确保只安装一次：

var installOnce sync.Once

func TestPT_04(t *testing.T) {
    installOnce.Do(func() {
        if err := playwright.Install(); err != nil {
            t.Fatalf("安装失败: %v", err)
        }
    })
    // 其余测试代码...
}

方案三：环境隔离

在CI/CD环境中，可以为每个并行任务创建独立的工作空间：

jobs:
  test:
    strategy:
      matrix:
        shard: [1, 2]
    steps:
      - uses: actions/checkout@v4
      - run: mkdir -p ./workspace-${{ matrix.shard }}
      - run: cd ./workspace-${{ matrix.shard }} && go test -p 1 ./...

最佳实践建议

1. 缓存管理：在CI/CD流水线中，合理清理缓存目录
2. 资源隔离：为每个并行任务提供独立的环境
3. 错误处理：增强错误处理逻辑，提供更有意义的错误信息
4. 版本控制：确保所有并行任务使用相同的Playwright版本

通过以上方法，开发者可以有效解决Playwright-Go在并行测试环境中的驱动安装冲突问题，构建更稳定可靠的自动化测试体系。