自动化测试 / 系统课时
管理环境配置
管理环境配置
同一套 Playwright 测试经常要在开发、测试和预发布环境重复执行。本篇把环境地址、账号选择和密钥来源集中管理,让测试代码只表达业务步骤,并能通过一个环境标识稳定切换目标。
学习目标
- 用统一环境标识切换
baseURL与对应账号 - 区分可提交的环境配置和必须外置的敏感信息
- 通过启动命令和失败保护确认当前测试环境
把环境差异收口到配置层
最容易失控的做法,是在测试文件里到处判断环境,再拼接完整 URL。这样一旦地址变化,几十个用例都可能需要修改。更稳妥的方式是让 playwright.config.ts 只负责选择环境和 baseURL,测试始终使用相对路径。
下面是配置片段示例,依赖项目现有的 Playwright 安装;地址为示例值,接入时替换为真实环境地址。
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 选择变量名,并在缺少凭据时立即失败。登录路径和选择器需按项目页面替换。
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/);
});预期结果:当目标环境可访问、账号有效且页面选择器匹配时,该用例通过;若当前环境缺少账号变量,会在访问页面前直接报告缺失凭据,而不是继续执行错误登录。
1 passed (<TIME>)<TIME> 会随机器性能和目标环境响应速度变化。实际项目中应把 E2E_DEV_USER、E2E_TEST_USER、E2E_STAGING_USER 及对应密码放在本地安全环境或 CI Secret 中。
用一个入口执行和核对环境
假设测试环境的账号变量已经由终端配置或 CI 注入,可以只切换 TEST_ENV。以下命令选择预发布环境,不在命令行直接写密码。
TEST_ENV=staging npx playwright test tests/login.spec.ts预期输出
Running 1 test using <VALUE> worker
1 passed (<TIME>)<VALUE> 和 <TIME> 是动态值。若把 TEST_ENV 写成未支持的值,例如 prodution,配置文件会在测试开始前抛出 Unsupported TEST_ENV,这类快速失败比静默回退到默认环境更安全。
保持环境配置可审计
可提交到仓库的内容应包括环境名称、非敏感地址和选择规则;密码、Token、Cookie 等应由 CI Secret、密钥管理服务或本地环境变量注入。团队还应明确默认环境,通常选择隔离的测试环境,而不是生产环境。
环境管理的目标不是增加配置层数,而是让测试文件不再关心“现在跑在哪”。当地址选择、账号来源和失败保护都有唯一入口后,同一批用例才能可靠地复用于开发、测试和预发布环境。