自动化测试 / 系统课时

管理多环境配置

管理多环境配置

同一套 Selenium 用例通常要在开发、测试和预发布环境运行,但地址、测试账号和开关不应散落在测试代码里。本篇把环境差异集中到一个配置入口,并把密码留在环境变量中,做到切换环境时只改一个选择值。

学习目标

  • 用明确的环境名选择不同的 base_url、账号和超时参数。
  • 把非敏感配置与密码等敏感信息分开管理。
  • 在创建 WebDriver 前校验配置,避免连错环境后才发现问题。

把变化收敛到一个配置入口

先固定环境集合,例如 dev、test、staging。页面对象只接收已经解析好的 base_url,测试用例只接收账号,不应在各文件里判断当前环境。

下面的 config_demo.py 可以直接运行,它用 dataclass 保存非敏感配置,并把密码映射为环境变量名。

python
from dataclasses import dataclass
import argparse
import os

@dataclass(frozen=True)
class EnvConfig:
    base_url: str
    username: str
    password_env: str
    page_load_timeout: int

CONFIGS = {
    "dev": EnvConfig("https://dev.example.test", "e2e-dev", "E2E_DEV_PASSWORD", 15),
    "test": EnvConfig("https://test.example.test", "e2e-test", "E2E_TEST_PASSWORD", 20),
    "staging": EnvConfig("https://staging.example.test", "e2e-staging", "E2E_STAGING_PASSWORD", 30),
}

def load_config(name: str) -> EnvConfig:
    try:
        return CONFIGS[name]
    except KeyError as exc:
        raise SystemExit(f"unknown environment: {name}") from exc

def main() -> None:
    parser = argparse.ArgumentParser()
    parser.add_argument("--env", choices=CONFIGS, default="test")
    args = parser.parse_args()

    cfg = load_config(args.env)
    has_password = bool(os.getenv(cfg.password_env))
    print(f"{args.env}: {cfg.base_url}")
    print(f"user={cfg.username}, timeout={cfg.page_load_timeout}s")
    print(f"password configured={has_password}")

if __name__ == "__main__":
    main()

预期输出:运行 python config_demo.py --env test,且尚未设置密码环境变量时:

text
test: https://test.example.test
user=e2e-test, timeout=20s
password configured=False

这里故意不把真实密码写进 CONFIGS。仓库中可以保存环境名、地址和超时;密码、令牌等秘密只由 CI Secret、系统环境变量或专用密钥服务注入。

在 WebDriver 初始化前完成校验

真正启动浏览器前,应同时检查环境名、URL 协议和密码是否存在。这样错误会在测试初始化阶段直接暴露,而不是跑到登录页面后才以“元素找不到”表现出来。

片段示例:下面代码依赖前面的 EnvConfig 与 load_config,并要求已经安装 Selenium;它展示配置如何传给 Chrome,会话创建后再访问目标环境。

python
import os
from urllib.parse import urlparse
from selenium import webdriver

cfg = load_config("test")
password = os.getenv(cfg.password_env)
if not password:
    raise RuntimeError(f"missing secret: {cfg.password_env}")

parsed = urlparse(cfg.base_url)
if parsed.scheme != "https" or not parsed.netloc:
    raise RuntimeError(f"invalid base_url: {cfg.base_url}")

driver = webdriver.Chrome()
driver.set_page_load_timeout(cfg.page_load_timeout)
driver.get(cfg.base_url)

验证方法是先在 CI 或本机设置对应密码,再启动测试;若密码缺失,应在 webdriver.Chrome() 之前得到 RuntimeError。如果团队允许开发环境使用 HTTP,应把这一例外做成显式白名单,而不是删除 URL 校验。

让账号和环境一一对应

不要让同一个账号跨多个环境复用,尤其不要把预发布账号拿到开发环境。可采用固定命名:e2e-dev、e2e-test、e2e-staging,并分别使用 E2E_DEV_PASSWORD、E2E_TEST_PASSWORD、E2E_STAGING_PASSWORD。

环境 基础地址 测试账号 页面加载超时
dev https://dev.example.test e2e-dev 15 秒
test https://test.example.test e2e-test 20 秒
staging https://staging.example.test e2e-staging 30 秒

这样日志里只要打印环境名和用户名即可定位问题,又不会泄露密码。账号权限也应尽量固定,例如普通回归账号不要同时拥有管理员权限,否则不同环境的权限差异会掩盖真实缺陷。

防止误跑到错误环境

CI 最好把目标环境作为受控参数,并对高风险环境增加域名白名单。例如预发布任务只接受主机名 staging.example.test,发现其他主机立即终止。

最终验收可以检查三件事:切换 --env 后 base_url 和账号同步变化;缺少密码时在浏览器启动前失败;测试日志只出现环境名和用户名,不出现密码或令牌。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理多环境配置

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

登录哪都通