Playwright多Worker场景下的身份认证处理问题咨询

针对你遇到的问题，结合Playwright特性和老旧系统限制，直接给出落地方案与避坑点：

核心前提明确 #

Playwright默认每个测试文件对应一个独立Worker，Worker间的浏览器上下文完全隔离。但如果配置多Worker（如workers: 3），会同时运行多个测试文件，此时共用单账号必然会出现服务端数据互相覆盖的问题。

最佳实践方案 #

1. 按测试文件隔离登录状态，减少重复登录 #

每个测试文件仅执行一次登录，后续测试复用该状态，既提升效率，又能在一定程度上隔离不同文件的测试（不同Worker用各自上下文）。

方式一：beforeAll() + beforeEach() 实现

import { test } from '@playwright/test';
import fs from 'fs';

// 生成基于当前测试文件的唯一状态文件名
const statePath = `.auth/${__filename.replace(/\//g, '_')}.json`;

test.beforeAll(async ({ browser }) => {
  // 仅当状态文件不存在时执行登录
  if (!fs.existsSync(statePath)) {
    const context = await browser.newContext();
    const page = await context.newPage();
    
    // 执行表单登录流程
    await page.goto('/login');
    await page.fill('#username', 'your-account');
    await page.fill('#password', 'your-password');
    await page.click('#login-btn');
    
    // 保存登录状态到文件
    await context.storageState({ path: statePath });
    await context.close();
  }
});

test.beforeEach(async ({ browser }) => {
  // 每个测试前加载已保存状态，创建隔离上下文
  const context = await browser.newContext({ storageState: statePath });
  await context.newPage();
});

方式二：Playwright Fixture（更推荐，灵活性更高）

Fixture可封装登录逻辑，自动处理状态加载与复用，还能结合测试文件做隔离：

import { test as base } from '@playwright/test';
import fs from 'fs';
import path from 'path';

type AuthenticatedFixtures = {
  authenticatedPage: Page;
};

// 扩展基础测试，添加自定义fixture
const test = base.extend<AuthenticatedFixtures>({
  authenticatedPage: async ({ browser }, use) => {
    // 生成基于当前测试文件的唯一状态文件名
    const relativePath = path.relative(process.cwd(), test.info().file);
    const stateFilename = relativePath.replace(/[\/\\]/g, '_') + '.json';
    const statePath = path.join('.auth', stateFilename);

    // 创建上下文：优先加载已保存状态
    const context = await browser.newContext({
      storageState: fs.existsSync(statePath) ? statePath : undefined,
    });

    // 无状态文件时执行登录并保存
    if (!fs.existsSync(statePath)) {
      const page = await context.newPage();
      await page.goto('/login');
      await page.fill('#username', 'your-account');
      await page.fill('#password', 'your-password');
      await page.click('#login-btn');
      await page.waitForURL('/dashboard'); // 确保登录完成
      await context.storageState({ path: statePath });
    }

    const page = await context.newPage();
    await use(page);
    await context.close(); // 测试结束后清理资源
  },
});

export default test;

使用时直接注入authenticatedPage即可：

import test from './fixtures';

test('创建订单', async ({ authenticatedPage }) => {
  await authenticatedPage.goto('/orders/new');
  // 执行CRUD操作...
});

2. 单账号下的测试隔离关键：强制清理+无状态依赖 #

所有测试共用同一账号时，必须保证每个测试结束后服务端状态回归初始：

• 在afterEach()中执行清理：删除测试创建的记录、重置修改的配置、清空表单数据等；
• 测试设计无顺序依赖：每个测试从干净状态开始，不依赖其他测试生成的数据；
• 无法回滚的操作（如修改用户基础信息）：单独放在一个文件，用test.describe.configure({ mode: 'serial' })配置串行执行。

3. Worker数量与账号的对应策略 #

• 启用多Worker提效：必须准备与Worker数量一致的独立账号，每个Worker用不同账号，避免并发操作同一账号数据；
• 仅单账号可用：将playwright.config.ts中workers设为1，串行执行所有测试文件，彻底避免数据冲突。

必须避开的陷阱 #

• 并发数据冲突：多Worker用单账号时，同时修改同一条数据导致断言失败；
• 状态文件污染：多个测试文件共用同一状态文件，导致不同Worker上下文互相干扰（务必按测试文件生成唯一状态文件名）；
• 清理不彻底：漏删测试数据、无法回滚操作，导致后续测试环境不干净；
• 测试依赖顺序：测试B依赖测试A的结果，一旦A失败或顺序变更，B必然失败。

要不要为每个测试单独创建账号？ #

如果测试操作无法通过清理隔离（如修改全局权限、资金操作），或清理成本极高，最好为每个测试创建独立账号。若无多账号资源，只能依赖严格清理+串行执行保证测试稳定性。

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