自动化测试 / 系统课时
管理多环境配置
管理多环境配置
同一套 Selenium 用例通常要在开发、测试和预发布环境运行,但地址、测试账号和开关不应散落在测试代码里。本篇把环境差异集中到一个配置入口,并把密码留在环境变量中,做到切换环境时只改一个选择值。
学习目标
- 用明确的环境名选择不同的
base_url、账号和超时参数。 - 把非敏感配置与密码等敏感信息分开管理。
- 在创建 WebDriver 前校验配置,避免连错环境后才发现问题。
把变化收敛到一个配置入口
先固定环境集合,例如 dev、test、staging。页面对象只接收已经解析好的 base_url,测试用例只接收账号,不应在各文件里判断当前环境。
下面的 config_demo.py 可以直接运行,它用 dataclass 保存非敏感配置,并把密码映射为环境变量名。
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,且尚未设置密码环境变量时:
test: https://test.example.test
user=e2e-test, timeout=20s
password configured=False这里故意不把真实密码写进 CONFIGS。仓库中可以保存环境名、地址和超时;密码、令牌等秘密只由 CI Secret、系统环境变量或专用密钥服务注入。
在 WebDriver 初始化前完成校验
真正启动浏览器前,应同时检查环境名、URL 协议和密码是否存在。这样错误会在测试初始化阶段直接暴露,而不是跑到登录页面后才以“元素找不到”表现出来。
片段示例:下面代码依赖前面的 EnvConfig 与 load_config,并要求已经安装 Selenium;它展示配置如何传给 Chrome,会话创建后再访问目标环境。
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 和账号同步变化;缺少密码时在浏览器启动前失败;测试日志只出现环境名和用户名,不出现密码或令牌。