自动化测试 / 系统课时

管理多角色账号

管理多角色账号

当同一套端到端测试既要覆盖管理员权限,又要覆盖普通用户路径时,最稳妥的做法不是在每条测试里重复登录,而是为每个角色保存独立认证状态,并让对应测试项目只加载自己的状态文件。

学习目标

  • 为管理员、普通用户生成彼此独立的 storageState 文件
  • 用 Playwright 项目配置把角色与认证状态固定绑定
  • 识别浏览器状态隔离与服务端测试数据隔离的边界

为什么每个角色要独立状态

Playwright 的认证状态通常包含 Cookie、Local Storage 等浏览器侧凭据。管理员和普通用户若复用同一个状态文件,后写入的身份会覆盖前一个身份,测试名称虽然不同,实际却可能一直以同一账号执行。

更可靠的模型是“一种角色对应一份状态文件,再对应一组测试”。测试运行时,Playwright 根据项目配置创建隔离的浏览器上下文,并在上下文启动前加载该角色的认证状态。

多角色认证状态与测试项目的映射关系

生成两份认证状态

下面示例使用一个 setup 文件分别登录两个测试账号,并保存为独立状态。示例假设应用运行在 http://127.0.0.1:3000,登录页存在 Email、Password 输入框和 Sign in 按钮;账号密码通过环境变量提供。

ts
import { test as setup, expect, type Page } from '@playwright/test';
import { mkdirSync } from 'node:fs';
import path from 'node:path';

const authDir = path.resolve('playwright/.auth');
mkdirSync(authDir, { recursive: true });

function requiredEnv(name: string): string {
  const value = process.env[name];
  if (!value) throw new Error(`Missing environment variable: ${name}`);
  return value;
}

async function signIn(page: Page, email: string, password: string, stateFile: string) {
  // 每个 setup 测试使用自己的页面与上下文,避免角色状态互相覆盖。
  await page.goto('http://127.0.0.1:3000/login');
  await page.getByLabel('Email').fill(email);
  await page.getByLabel('Password').fill(password);
  await page.getByRole('button', { name: 'Sign in' }).click();

  await expect(page).toHaveURL(/\/dashboard/);
  // 只在确认登录成功后落盘,避免把匿名状态误当成可复用认证状态。
  await page.context().storageState({ path: stateFile });
}

setup('保存管理员状态', async ({ page }) => {
  await signIn(
    page,
    requiredEnv('E2E_ADMIN_EMAIL'),
    requiredEnv('E2E_ADMIN_PASSWORD'),
    path.join(authDir, 'admin.json'),
  );
});

setup('保存普通用户状态', async ({ page }) => {
  await signIn(
    page,
    requiredEnv('E2E_USER_EMAIL'),
    requiredEnv('E2E_USER_PASSWORD'),
    path.join(authDir, 'user.json'),
  );
});

预期结果

text
登录成功后生成:
playwright/.auth/admin.json
playwright/.auth/user.json

两个文件分别保存对应账号的浏览器认证状态;实际 Cookie、令牌和时间字段会因应用而不同。

如果应用把登录令牌放在 IndexedDB 中,保存状态时还需要根据应用实现确认是否应包含 IndexedDB;不要仅凭“文件已生成”判断认证一定可复用。

把角色绑定到测试项目

角色映射应放在 playwright.config.ts,而不是由测试用例临时选择状态文件。这样测试文件只关心业务行为,项目负责提供正确身份。

ts
import { defineConfig } from '@playwright/test';
import path from 'node:path';

const authDir = path.resolve('playwright/.auth');

export default defineConfig({
  use: {
    baseURL: 'http://127.0.0.1:3000',
  },
  projects: [
    {
      name: 'setup',
      testMatch: /auth\.setup\.ts/,
    },
    {
      name: 'admin',
      testMatch: /.*\.admin\.spec\.ts/,
      dependencies: ['setup'],
      use: { storageState: path.join(authDir, 'admin.json') },
    },
    {
      name: 'user',
      testMatch: /.*\.user\.spec\.ts/,
      dependencies: ['setup'],
      use: { storageState: path.join(authDir, 'user.json') },
    },
  ],
});

生效后,*.admin.spec.ts 会在管理员状态下启动,*.user.spec.ts 会在普通用户状态下启动;测试代码无需再次执行登录流程。验证时可以让两个项目访问同一受保护页面,分别断言管理员操作是否可见、普通用户是否被禁止执行该操作。

浏览器隔离不等于数据隔离

独立 storageState 只能保证浏览器身份不混用,不能阻止两个并行测试同时修改同一服务端账号、订单或配置。如果多个测试会写入相同业务数据,应为它们分配不同账号或不同数据命名空间,而不是仅复制更多状态文件。

状态文件还可能因会话过期、密码变更或服务端撤销而失效。遇到“文件存在但仍跳回登录页”时,应先重新生成状态并验证账号本身可登录,再检查测试项目是否加载了正确文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理多角色账号

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通