feat: 重构测试框架 — 覆盖 6 端 (管理端 + 小程序 + 4 个移动端)

目录结构:
  tests/web/admin/       管理端 (Playwright)
  tests/web/mini_program/ 司机端小程序 (Playwright/微信 WebView)
  tests/app/driver_android/  司机安卓 (Appium)
  tests/app/shipper_android/ 货主安卓 (Appium)
  tests/app/driver_ios/      司机苹果 (Appium)
  tests/app/shipper_ios/     货主苹果 (Appium)

公共模块:
  tests/app/_shared.py       driver+ensure_logged_in 工厂
  tests/app/_base_page.py    App Page Object 基类

配置:
  test_config.yaml 拆分为 6 个独立 section + 货主账号
This commit is contained in:
xst
2026-07-15 14:02:08 +08:00
parent 4b4b83a2c0
commit 03e152baab
37 changed files with 823 additions and 727 deletions
+126
View File
@@ -0,0 +1,126 @@
"""管理端 fixture — Playwright 浏览器实例 + 登录态复用。
核心机制:
skip_login: true → 加载 storage_state,跳过验证码
skip_login: false → 执行完整 UI 登录
初始化:
python tests/web/admin/save_auth.py
"""
from datetime import datetime
from pathlib import Path
import pytest
from playwright.sync_api import sync_playwright, Page
SCREENSHOTS_DIR = Path("output/screenshots")
@pytest.fixture(params=["chromium", "firefox"])
def browser_name(admin_config, request):
"""每个浏览器执行一轮。"""
browsers = admin_config.get("browsers", ["chromium", "firefox"])
request.param = browsers[len(getattr(request, "_index", 0))]
return request.param
@pytest.fixture
def page(admin_config, browser_name, request) -> Page:
"""Playwright Page,加载登录态,失败自动截图。"""
viewport = admin_config.get("viewport", {"width": 1920, "height": 1080})
timeout = admin_config.get("timeout_seconds", 120) * 1000
skip_login = admin_config.get("skip_login", True)
storage_state_dir = Path(admin_config.get("storage_state_dir", "tests/web/auth"))
with sync_playwright() as p:
browser_launcher = getattr(p, browser_name)
browser = browser_launcher.launch(headless=True)
context_kwargs = {
"viewport": {"width": viewport["width"], "height": viewport["height"]},
"locale": "zh-CN",
}
loaded_role = None
if skip_login:
loaded_role = _load_auth_state(context_kwargs, storage_state_dir, browser_name)
context = browser.new_context(**context_kwargs)
page = context.new_page()
page.set_default_timeout(timeout)
page._auth_role = loaded_role
yield page
if hasattr(request.node, "rep_call") and request.node.rep_call.failed:
scenario_dir = SCREENSHOTS_DIR / request.node.name
scenario_dir.mkdir(parents=True, exist_ok=True)
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
path = str(scenario_dir / f"FAIL_{browser_name}_{ts}.png")
page.screenshot(path=path, full_page=True)
context.close()
browser.close()
@pytest.fixture
def ensure_login(admin_config, page, config):
"""确保管理端已登录。"""
def _ensure_login(role: str = "super_admin") -> None:
account = config["accounts"].get(role)
if not account:
raise ValueError(f"未知角色 '{role}',可用: {list(config['accounts'].keys())}")
base_url = admin_config["base_url"]
skip_login = admin_config.get("skip_login", True)
if skip_login:
auth_role = getattr(page, "_auth_role", None)
if auth_role == role:
page.goto(base_url)
page.wait_for_timeout(2000)
if "#/login" not in page.url and "/login" not in page.url:
return
raise RuntimeError(
f"登录态已过期!请运行: python tests/web/admin/save_auth.py --role {role}"
)
if auth_role and auth_role != role:
raise RuntimeError(
f"当前 storage_state 角色为 '{auth_role}',请求 '{role}'\n"
f"请运行: python tests/web/admin/save_auth.py --role {role}"
)
raise RuntimeError(
f"未找到角色 '{role}' 的登录态文件!请运行:\n"
f" python tests/web/admin/save_auth.py --role {role}"
)
# skip_login: false
page.goto(f"{base_url}/#/login")
page.get_by_placeholder("请输入用户名").fill(account["phone"])
page.get_by_placeholder("请输入密码").fill(account["password"])
page.get_by_role("button", name="登录").click()
page.wait_for_timeout(3000)
if "#/login" in page.url or "/login" in page.url:
raise RuntimeError(
"登录失败!可能存在图形验证码。请改为手动登录: python tests/web/admin/save_auth.py"
)
return _ensure_login
def _load_auth_state(context_kwargs: dict, storage_dir: Path, browser: str) -> str | None:
auth_files = list(storage_dir.glob(f"*_{browser}.json")) if storage_dir.exists() else []
if not auth_files:
return None
auth_file = auth_files[0]
context_kwargs["storage_state"] = str(auth_file)
return auth_file.stem.replace(f"_{browser}", "")
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
def pytest_runtest_makereport(item, call):
outcome = yield
rep = outcome.get_result()
setattr(item, f"rep_{rep.when}", rep)
@@ -3,7 +3,7 @@
跨页面复用的顶部/侧边导航操作
Usage:
from tests.web.pages.components.navbar import NavBar
from tests.web.admin.pages.components.navbar import NavBar
navbar = NavBar(page)
navbar.go_to("运输管理")
@@ -11,7 +11,7 @@ Usage:
from playwright.sync_api import Page, expect
from tests.web.pages.base_page import BasePage
from tests.web.admin.pages.base_page import BasePage
class NavBar(BasePage):
@@ -1,7 +1,7 @@
"""登录页面 — Page Object。
Usage:
from tests.web.pages.login_page import LoginPage
from tests.web.admin.pages.login_page import LoginPage
login_page = LoginPage(page)
login_page.login(phone="super_admin", password="951260684NiAn..")
@@ -9,7 +9,7 @@ Usage:
from playwright.sync_api import Page, expect
from tests.web.pages.base_page import BasePage
from tests.web.admin.pages.base_page import BasePage
class LoginPage(BasePage):
@@ -5,7 +5,7 @@
cookies + localStorage 序列化到 JSON 文件后续用例自动复用
用法:
python tests/web/save_auth.py
python tests/web/admin/save_auth.py
流程:
1. 脚本打开浏览器到登录页
@@ -44,7 +44,7 @@ def main():
args = parser.parse_args()
config = load_config()
web_config = config["web"]
web_config = config["admin"]
base_url = web_config["base_url"]
login_url = f"{base_url}/#/login"
@@ -92,7 +92,7 @@ def main():
browser.close()
print(f"\n🎉 现在可以跑了: pytest tests/web/ -m p0")
print(f"\n🎉 现在可以跑了: pytest tests/web/admin/ -m p0")
if __name__ == "__main__":
+74
View File
@@ -0,0 +1,74 @@
"""管理端登录测试用例。
标记:
pytest -m admin # 仅管理端用例
pytest -m p0 # P0 冒烟
pytest -m smoke # 冒烟
"""
import pytest
from playwright.sync_api import Page
pytestmark = [pytest.mark.admin]
class TestAdminSmoke:
"""管理端冒烟 — 验证预登录态。"""
@pytest.mark.p0
@pytest.mark.smoke
def test_admin_access_with_saved_auth(self, page: Page, admin_config, ensure_login):
"""验证预登录态可直接访问管理后台。"""
ensure_login("super_admin")
page.goto(admin_config["base_url"])
page.wait_for_timeout(2000)
assert "#/login" not in page.url and "/login" not in page.url, (
"预登录态失效!请运行: python tests/web/admin/save_auth.py"
)
@pytest.mark.p0
@pytest.mark.smoke
def test_team_leader_access(self, page: Page, admin_config, ensure_login):
"""验证车队长预登录态有效。"""
ensure_login("team_leader")
page.goto(admin_config["base_url"])
page.wait_for_timeout(2000)
assert "#/login" not in page.url and "/login" not in page.url
@pytest.mark.p0
@pytest.mark.smoke
def test_dashboard_loads(self, page: Page, admin_config, ensure_login):
"""验证首页可正常加载。"""
ensure_login("super_admin")
page.goto(admin_config["base_url"])
assert page.title(), "首页应显示页面标题"
class TestLoginPage:
"""登录页交互验证。"""
@pytest.mark.p1
def test_login_page_accessible(self, page: Page, admin_config):
"""验证登录页可正常访问。"""
page.goto(f"{admin_config['base_url']}/#/login")
assert page.get_by_placeholder("请输入用户名").is_visible()
@pytest.mark.p1
def test_login_page_elements(self, page: Page, admin_config):
"""验证登录页元素完整。"""
page.goto(f"{admin_config['base_url']}/#/login")
assert page.get_by_placeholder("请输入用户名").is_visible()
assert page.get_by_placeholder("请输入密码").is_visible()
assert page.get_by_role("button", name="登录").is_visible()
@pytest.mark.p1
def test_session_redirect(self, page: Page, admin_config, ensure_login):
"""验证已登录用户访问登录页被重定向。"""
ensure_login("super_admin")
page.goto(admin_config["base_url"])
page.wait_for_timeout(2000)
assert "#/login" not in page.url
page.goto(f"{admin_config['base_url']}/#/login")
page.wait_for_timeout(2000)
assert "#/login" not in page.url and "/login" not in page.url
File diff suppressed because one or more lines are too long
-180
View File
@@ -1,180 +0,0 @@
"""
Web 端根级 fixture:浏览器实例 + 登录态复用 + 失败自动截图。
核心机制 — 跳过图形验证码:
配置 web.skip_login: true 时,读取已保存的 storage_statecookies + localStorage),
跳过 UI 登录步骤。首次需要手动登录一次来生成 auth 文件。
首次初始化流程:
1. python tests/web/save_auth.py
2. 打开的浏览器中手动完成验证码登录
3. 登录态自动保存到 tests/web/auth/<role>.json
后续用例执行时自动复用,过期后重新运行 save_auth.py 即可。
提供:
browser_name — 参数化 fixture,每个浏览器执行一轮
page — Playwright Page 对象(已加载登录态)
ensure_login — 确保指定角色的登录态有效,未登录则报错提示
"""
from datetime import datetime
from pathlib import Path
import pytest
from playwright.sync_api import sync_playwright, Page, BrowserContext
SCREENSHOTS_DIR = Path("output/screenshots")
AUTH_DIR = Path(__file__).parent / "auth"
@pytest.fixture(scope="session")
def web_config(config):
"""session 级:Web 配置段。"""
return config["web"]
@pytest.fixture(params=["chromium", "firefox"])
def browser_name(web_config):
"""每个浏览器执行一次同一套用例。
可从命令行覆盖: pytest --browser=chromium tests/web/
"""
return request.param
@pytest.fixture
def page(web_config, browser_name, request) -> Page:
"""每个用例独立的 Playwright Page,自动加载登录态,失败自动截图。"""
viewport = web_config.get("viewport", {"width": 1920, "height": 1080})
timeout = web_config.get("timeout_seconds", 120) * 1000
screenshot_on_failure = web_config.get("screenshot_on_failure", True)
skip_login = web_config.get("skip_login", True)
storage_state_dir = Path(web_config.get("storage_state_dir", "tests/web/auth"))
with sync_playwright() as p:
browser_launcher = getattr(p, browser_name)
browser = browser_launcher.launch(headless=True)
# ── 构建 context ──
context_kwargs = {
"viewport": {"width": viewport["width"], "height": viewport["height"]},
"locale": "zh-CN",
}
# 如果启用跳过登录,尝试加载 storage_state
loaded_role = None
if skip_login:
loaded_role = _load_auth_state(context_kwargs, storage_state_dir, browser_name)
context = browser.new_context(**context_kwargs)
page = context.new_page()
page.set_default_timeout(timeout)
# 将当前 context 的登录角色注入 page(用例中可检查)
page._auth_role = loaded_role
yield page
# ── 失败自动截图 ──
if screenshot_on_failure and hasattr(request.node, "rep_call") and request.node.rep_call.failed:
scenario_dir = SCREENSHOTS_DIR / request.node.name
scenario_dir.mkdir(parents=True, exist_ok=True)
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
path = str(scenario_dir / f"FAIL_{browser_name}_{ts}.png")
page.screenshot(path=path, full_page=True)
context.close()
browser.close()
@pytest.fixture
def ensure_login(web_config, page, config):
"""确保已登录状态,未登录则自动执行 UI 登录(含验证码则报错)。
用法一(推荐 — 配置 skip_login: true:
def test_xxx(page, ensure_login):
ensure_login("super_admin")
# page 已处于登录后的管理后台
用法二(skip_login: false — 完整 UI 登录):
def test_xxx(page, ensure_login):
ensure_login("super_admin") # 执行完整 UI 登录
"""
def _ensure_login(role: str = "super_admin") -> None:
account = config["accounts"].get(role)
if not account:
raise ValueError(f"未知角色 '{role}',可用: {list(config['accounts'].keys())}")
base_url = web_config["base_url"]
skip_login = web_config.get("skip_login", True)
# 如果 storage_state 已加载且角色匹配,直接验证
if skip_login:
auth_role = getattr(page, "_auth_role", None)
if auth_role == role:
# 验证登录态是否仍然有效
page.goto(base_url)
# Hash 路由模式下判断是否重定向到登录页
page.wait_for_timeout(2000) # 等 hash 路由完成
if "/#/login" not in page.url and "/login" not in page.url:
return # 登录态有效
# 登录态过期,给出明确指引
raise RuntimeError(
f"登录态已过期或未生成!请运行以下命令重新生成:\n"
f" python tests/web/save_auth.py --role {role} --browser {_get_browser_name(page)}"
)
if auth_role and auth_role != role:
raise RuntimeError(
f"当前 storage_state 角色为 '{auth_role}',请求为 '{role}'\n"
f"请运行: python tests/web/save_auth.py --role {role}"
)
# 没有加载任何 auth,报错
raise RuntimeError(
f"未找到角色 '{role}' 的登录态文件!请运行:\n"
f" python tests/web/save_auth.py --role {role}"
)
# ── skip_login: false,执行 UI 登录(可能有验证码,会失败) ──
page.goto(f"{base_url}/#/login")
page.get_by_placeholder("请输入用户名").fill(account["phone"])
page.get_by_placeholder("请输入密码").fill(account["password"])
page.get_by_role("button", name="登录").click()
# 等几秒让页面处理路由跳转
page.wait_for_timeout(3000)
if "/#/login" in page.url or "/login" in page.url:
raise RuntimeError(
"登录失败!可能存在图形验证码。\n"
"请改为手动登录生成 auth 文件: python tests/web/save_auth.py --role {role}"
)
def _load_auth_state(context_kwargs: dict, storage_dir: Path, browser: str) -> str | None:
"""尝试加载登录态,返回角色名或 None。"""
auth_files = list(storage_dir.glob(f"*_{browser}.json")) if storage_dir.exists() else []
if not auth_files:
return None
auth_file = auth_files[0] # 加载第一个匹配的 auth 文件
context_kwargs["storage_state"] = str(auth_file)
# 从文件名提取角色名(格式: <role>_<browser>.json
role = auth_file.stem.replace(f"_{browser}", "")
return role
def _get_browser_name(page: Page) -> str:
"""从 page 推测浏览器名(用于错误提示)。"""
return "chromium" # 默认提示 chromium
# ── pytest 报告 hook ──
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
def pytest_runtest_makereport(item, call):
"""记录用例执行结果,供失败截图使用。"""
outcome = yield
rep = outcome.get_result()
setattr(item, f"rep_{rep.when}", rep)
+52
View File
@@ -0,0 +1,52 @@
"""司机端小程序 fixture — Playwright(模拟微信 WebView)。
核心机制:
模拟微信内置浏览器 UA,微信 WebView 仍需登录态。
首次使用 python tests/web/admin/save_auth.py 生成后用在此端也可以。
"""
from datetime import datetime
from pathlib import Path
import pytest
from playwright.sync_api import sync_playwright, Page
SCREENSHOTS_DIR = Path("output/screenshots")
@pytest.fixture
def page(mini_program_config, request) -> Page:
"""微信 WebView 模拟 Page。"""
viewport = mini_program_config.get("viewport", {"width": 375, "height": 812})
timeout = mini_program_config.get("timeout_seconds", 120) * 1000
user_agent = mini_program_config.get("user_agent", "Mozilla/5.0 MicroMessenger/8.0.0")
base_url = mini_program_config["base_url"]
with sync_playwright() as p:
browser = p.chromium.launch(headless=True)
context = browser.new_context(
viewport={"width": viewport["width"], "height": viewport["height"]},
user_agent=user_agent,
locale="zh-CN",
)
page = context.new_page()
page.set_default_timeout(timeout)
yield page
if hasattr(request.node, "rep_call") and request.node.rep_call.failed:
scenario_dir = SCREENSHOTS_DIR / request.node.name
scenario_dir.mkdir(parents=True, exist_ok=True)
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
path = str(scenario_dir / f"FAIL_mini_{ts}.png")
page.screenshot(path=path)
context.close()
browser.close()
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
def pytest_runtest_makereport(item, call):
outcome = yield
rep = outcome.get_result()
setattr(item, f"rep_{rep.when}", rep)
+31
View File
@@ -0,0 +1,31 @@
"""小程序 Page Object 基类。"""
from datetime import datetime
from pathlib import Path
from playwright.sync_api import Page, Locator, expect
SCREENSHOTS_DIR = Path("output/screenshots")
class MiniProgramBasePage:
"""小程序 Page Object 基类。"""
def __init__(self, page: Page, timeout_ms: int = 30_000):
self.page = page
self.timeout = timeout_ms
def wait_visible(self, locator: Locator, timeout_ms: int | None = None) -> None:
expect(locator).to_be_visible(timeout=timeout_ms or self.timeout)
def click_when_ready(self, locator: Locator) -> None:
self.wait_visible(locator)
locator.click()
def screenshot(self, name: str) -> str:
scenario_dir = SCREENSHOTS_DIR / self.__class__.__name__
scenario_dir.mkdir(parents=True, exist_ok=True)
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
path = str(scenario_dir / f"{name}_{ts}.png")
self.page.screenshot(path=path)
return path
@@ -0,0 +1,24 @@
"""小程序首页 — Page Object。
Usage:
from tests.web.mini_program.pages import MiniProgramBasePage
"""
from playwright.sync_api import Page
from tests.web.mini_program.pages import MiniProgramBasePage
class MiniHomePage(MiniProgramBasePage):
"""司机端小程序首页。"""
def __init__(self, page: Page):
super().__init__(page)
# ⚠️ 定位器需根据实际小程序 UI 确认
self.order_list_tab = page.get_by_text("运单")
self.mine_tab = page.get_by_text("我的")
def go_to_order_list(self) -> None:
self.click_when_ready(self.order_list_tab)
def go_to_mine(self) -> None:
self.click_when_ready(self.mine_tab)
@@ -0,0 +1,16 @@
"""小程序冒烟测试。"""
import pytest
pytestmark = [pytest.mark.mini_program]
class TestMiniProgramSmoke:
"""小程序基础验证。"""
@pytest.mark.p0
@pytest.mark.smoke
def test_mini_program_accessible(self, page, mini_program_config):
"""验证小程序首页可正常加载。"""
page.goto(mini_program_config["base_url"])
assert page.title(), "小程序首页应显示页面标题"
-111
View File
@@ -1,111 +0,0 @@
"""Web 登录功能测试用例。
覆盖:
- (skip_login: true) 验证预登录态有效,不经过 UI 登录页
- (skip_login: false) 完整 UI 登录流程 + 表单校验
标记:
pytest -m web # 仅执行 Web 用例
pytest -m p0 # 仅执行 P0 冒烟
pytest -m smoke # 仅执行冒烟
"""
import pytest
from playwright.sync_api import Page
pytestmark = [pytest.mark.web]
# ═══════════════════════════════════════════════════════════════════
# P0 — 冒烟测试(依赖预登录态,不触发 UI 登录)
# ═══════════════════════════════════════════════════════════════════
class TestLoginSmoke:
"""验证预登录态有效 + 后台可正常访问。"""
@pytest.mark.p0
@pytest.mark.smoke
def test_admin_access_with_saved_auth(self, page: Page, web_config, ensure_login):
"""验证加载预登录态后可直接访问管理后台,无需重新登录。"""
ensure_login("super_admin")
page.goto(web_config["base_url"])
# 等 hash 路由完成
page.wait_for_timeout(2000)
# 已登录状态下不应重定向到登录页
assert "#/login" not in page.url and "/login" not in page.url, (
f"预登录态失效!仍然重定向到登录页。请运行: python tests/web/save_auth.py"
)
@pytest.mark.p0
@pytest.mark.smoke
def test_team_leader_access_with_saved_auth(self, page: Page, web_config, ensure_login):
"""验证车队长预登录态有效。"""
ensure_login("team_leader")
page.goto(web_config["base_url"])
page.wait_for_timeout(2000)
assert "#/login" not in page.url and "/login" not in page.url
@pytest.mark.p0
@pytest.mark.smoke
def test_dashboard_loads(self, page: Page, web_config, ensure_login):
"""验证登录后首页能正常加载。"""
ensure_login("super_admin")
page.goto(web_config["base_url"])
# 页面标题应包含"运八"或类似标识
assert page.title(), "首页应显示页面标题"
# ═══════════════════════════════════════════════════════════════════
# P1 — 登录页交互(仅在 skip_login: false 时才有意义)
# ═══════════════════════════════════════════════════════════════════
class TestLoginPageDirect:
"""直接访问登录页相关用例(不依赖账号)。"""
@pytest.mark.p1
def test_login_page_accessible(self, page: Page, web_config):
"""验证登录页可直接访问并正常渲染。"""
page.goto(f"{web_config['base_url']}/#/login")
# 登录页应存在用户名输入框
assert page.get_by_placeholder("请输入用户名").is_visible()
@pytest.mark.p1
def test_login_page_elements(self, page: Page, web_config):
"""验证登录页所有关键元素存在。"""
page.goto(f"{web_config['base_url']}/#/login")
assert page.get_by_placeholder("请输入用户名").is_visible()
assert page.get_by_placeholder("请输入密码").is_visible()
assert page.get_by_role("button", name="登录").is_visible()
@pytest.mark.p1
def test_double_login_session_redirect(self, page: Page, web_config, ensure_login):
"""验证已登录用户访问登录页自动重定向。"""
ensure_login("super_admin")
page.goto(web_config["base_url"])
page.wait_for_timeout(2000)
assert "#/login" not in page.url and "/login" not in page.url
# 已登录状态再次访问登录页
page.goto(f"{web_config['base_url']}/#/login")
page.wait_for_timeout(2000)
# 应被重定向到后台
assert "#/login" not in page.url and "/login" not in page.url, (
f"已登录用户访问 /login 应被重定向,当前: {page.url}"
)
# ═══════════════════════════════════════════════════════════════════
# P2 — UI 登录流程(仅 skip_login: false 时执行,有验证码时预期跳过)
# ═══════════════════════════════════════════════════════════════════
@pytest.mark.p2
@pytest.mark.skip_login_required # 自定义 marker:仅在 skip_login: false 时生效
class TestLoginUI:
"""完整 UI 登录(需要 skip_login: false)。"""
def test_full_ui_login_super_admin(self, page: Page, web_config, ensure_login):
"""通过 UI 完成完整登录(需要手动关闭 skip_login)。"""
ensure_login("super_admin")
page.goto(web_config["base_url"])
page.wait_for_timeout(2000)
assert "#/login" not in page.url and "/login" not in page.url