自动化测试 / 系统课时

管理环境配置

管理环境配置

同一套 Playwright 测试经常要在开发、测试和预发布环境重复执行。本篇把环境地址、账号选择和密钥来源集中管理,让测试代码只表达业务步骤,并能通过一个环境标识稳定切换目标。

学习目标

  • 用统一环境标识切换 baseURL 与对应账号
  • 区分可提交的环境配置和必须外置的敏感信息
  • 通过启动命令和失败保护确认当前测试环境

把环境差异收口到配置层

最容易失控的做法,是在测试文件里到处判断环境,再拼接完整 URL。这样一旦地址变化,几十个用例都可能需要修改。更稳妥的方式是让 playwright.config.ts 只负责选择环境和 baseURL,测试始终使用相对路径。

下面是配置片段示例,依赖项目现有的 Playwright 安装;地址为示例值,接入时替换为真实环境地址。

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

type EnvName = 'dev' | 'test' | 'staging';

const envName = (process.env.TEST_ENV ?? 'test') as EnvName;
const baseURLs: Record<EnvName, string> = {
  dev: 'http://127.0.0.1:3000',
  test: 'https://test.example.com',
  staging: 'https://staging.example.com',
};

// 尽早拒绝未知环境,避免误把测试打到错误目标。
if (!baseURLs[envName]) {
  throw new Error(`Unsupported TEST_ENV: ${envName}`);
}

export default defineConfig({
  use: {
    baseURL: baseURLs[envName],
    trace: 'on-first-retry',
  },
});

该配置生效后,page.goto('/login') 会自动基于当前 baseURL 解析地址。验证时不需要把环境判断复制到测试代码中;只要检查运行命令选择的 TEST_ENV 是否正确即可。

让账号跟随环境而不是写死在用例里

账号名和密码属于运行时数据。环境与账号的对应关系可以由代码决定,但真实密码不应提交到仓库。下面是登录测试的片段示例,依赖项目真实登录页及账号;它根据 TEST_ENV 选择变量名,并在缺少凭据时立即失败。登录路径和选择器需按项目页面替换。

ts
import { test, expect } from '@playwright/test';

type EnvName = 'dev' | 'test' | 'staging';
const envName = (process.env.TEST_ENV ?? 'test') as EnvName;

function readCredentials() {
  const suffix = envName.toUpperCase();
  const username = process.env[`E2E_${suffix}_USER`];
  const password = process.env[`E2E_${suffix}_PASSWORD`];

  // 缺少凭据时停止测试,避免用空值继续执行并产生误导性失败。
  if (!username || !password) {
    throw new Error(`Missing credentials for ${envName}`);
  }

  return { username, password };
}

test('当前环境账号可以登录', async ({ page }) => {
  const { username, password } = readCredentials();

  await page.goto('/login');
  await page.getByLabel('用户名').fill(username);
  await page.getByLabel('密码').fill(password);
  await page.getByRole('button', { name: '登录' }).click();

  await expect(page).toHaveURL(/dashboard/);
});

预期结果:当目标环境可访问、账号有效且页面选择器匹配时,该用例通过;若当前环境缺少账号变量,会在访问页面前直接报告缺失凭据,而不是继续执行错误登录。

text
1 passed (<TIME>)

<TIME> 会随机器性能和目标环境响应速度变化。实际项目中应把 E2E_DEV_USER、E2E_TEST_USER、E2E_STAGING_USER 及对应密码放在本地安全环境或 CI Secret 中。

用一个入口执行和核对环境

假设测试环境的账号变量已经由终端配置或 CI 注入,可以只切换 TEST_ENV。以下命令选择预发布环境,不在命令行直接写密码。

bash
TEST_ENV=staging npx playwright test tests/login.spec.ts

预期输出

text
Running 1 test using <VALUE> worker
1 passed (<TIME>)

<VALUE> 和 <TIME> 是动态值。若把 TEST_ENV 写成未支持的值,例如 prodution,配置文件会在测试开始前抛出 Unsupported TEST_ENV,这类快速失败比静默回退到默认环境更安全。

保持环境配置可审计

可提交到仓库的内容应包括环境名称、非敏感地址和选择规则;密码、Token、Cookie 等应由 CI Secret、密钥管理服务或本地环境变量注入。团队还应明确默认环境,通常选择隔离的测试环境,而不是生产环境。

环境管理的目标不是增加配置层数,而是让测试文件不再关心“现在跑在哪”。当地址选择、账号来源和失败保护都有唯一入口后,同一批用例才能可靠地复用于开发、测试和预发布环境。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理环境配置

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

登录哪都通