电商自动化测试框架实战：基于Python+Pytest+Selenium的工程化搭建

1. 项目概述：为什么电商网站必须做自动化测试？

做电商测试的朋友，应该都经历过“大促前夜”的噩梦。凌晨两点，你还在手动点着“加入购物车”、“提交订单”、“支付”，一遍又一遍，生怕哪个优惠券叠加逻辑出了问题，或者哪个新上的秒杀功能在流量洪峰下直接崩溃。这种重复、枯燥且极易出错的手工测试，不仅消耗测试人员的精力，更关键的是，它无法覆盖凌晨海量用户涌入时的真实场景。这就是为什么我们需要自动化测试，尤其是对于业务逻辑复杂、迭代飞快、对稳定性要求极高的电商网站。

“电商网站自动化测试实战：Selenium框架搭建全流程”这个标题，指向的正是解决上述痛点的核心方案。它不是一个简单的脚本集合，而是一套可维护、可复用、可扩展的工程化解决方案。Selenium作为老牌且强大的Web UI自动化工具，是我们实现浏览器操作自动化的利器。但仅仅会写Selenium脚本，距离一个健壮的自动化测试框架还有很远的距离。本次实战，我将带你从零开始，搭建一个专为电商网站量身定制的、基于Python+Pytest+Selenium的自动化测试框架。我们会覆盖环境搭建、框架设计、用例编写、报告生成到持续集成（CI）接入的全流程，并分享大量在真实电商项目中踩坑后总结出的经验。

无论你是刚接触自动化测试的新手，还是想优化现有测试流程的资深测试，这篇文章都将提供一条清晰的路径和可直接“抄作业”的代码与配置。我们将聚焦于电商的核心业务流，如用户登录、商品浏览、购物车管理、订单结算等，确保我们的框架能切实提升测试效率与产品质量。

2. 框架整体设计与技术选型考量

在动手写代码之前，花时间在设计上是绝对值得的。一个糟糕的框架后期维护成本会呈指数级增长。我们的目标是搭建一个结构清晰、易于维护、支持并发的自动化测试框架。

2.1 核心架构分层

我采用的是一种经典的分层架构模式，将不同的职责分离到不同的模块中，这大大提升了代码的可读性和可维护性。

基础层（Base Layer）：这是框架的基石。主要包含对Selenium WebDriver的二次封装。我们不会在测试用例中直接使用driver.find_element_by_id这样的原生方法，而是封装成更易用、更健壮的方法，比如click(locator)、input_text(locator, text)，并在其中加入显式等待、日志记录和失败截图等功能。这一层还负责WebDriver的初始化（如浏览器类型、选项配置）和销毁。

页面对象层（Page Object Layer）：这是Page Object Model（POM）设计模式的实现。每个页面（或页面中的重要组件）对应一个类，例如LoginPage、ProductPage、ShoppingCartPage。这个类中封装了该页面的所有元素定位符（Locators）和页面操作方法（如login(username, password)、add_to_cart()）。测试用例通过调用这些页面对象的方法来与页面交互，将页面细节与测试逻辑彻底解耦。当页面UI发生变化时，我们通常只需要修改对应的页面对象类，而不需要改动大量的测试用例。

测试用例层（Test Case Layer）：这一层包含具体的测试逻辑。我们使用Pytest来组织和运行测试用例。每个测试函数应该独立、可重复，并且只关注一个具体的测试场景。例如test_login_with_valid_credentials、test_add_single_item_to_cart。测试用例通过调用页面对象的方法来组合成完整的业务流。

数据层（Data Layer）：测试数据（如用户账号、商品ID、地址信息）应该与代码分离。我们可以使用JSON、YAML、Excel或CSV文件来管理数据，甚至连接测试数据库。Pytest的@pytest.mark.parametrize装饰器可以很好地实现数据驱动测试，用多组数据运行同一个测试逻辑。

工具层（Utility Layer）：存放通用工具，如读取配置文件、生成随机数据、发送邮件通知、操作数据库的辅助函数等。

报告层（Reporting Layer）：测试执行完毕后，我们需要一份清晰美观的测试报告。Allure报告是当前的主流选择，它提供了丰富的图表、步骤详情和附件（截图、日志）展示能力，能非常直观地反映测试结果。

2.2 技术栈选型与理由

• 编程语言：Python 3.8+

  • 理由：语法简洁，学习曲线平缓，拥有极其丰富的测试生态库（Pytest, Allure-pytest等）。Selenium对Python的支持也非常成熟。对于测试团队而言，Python是快速上手并产出效益的最佳选择之一。

• 自动化工具：Selenium 4.x

  • 理由：行业标准，社区活跃，浏览器支持最全面（Chrome, Firefox, Edge, Safari）。其WebDriver协议是事实标准。虽然新兴工具如Playwright在速度和稳定性上有其优势，但Selenium的成熟度、资料丰富度和招聘市场认可度，使其依然是企业级UI自动化，特别是需要兼容多浏览器项目的稳妥首选。

• 测试框架：Pytest

  • 理由：比Python自带的unittest更强大、更灵活。它支持丰富的插件（如并行执行、参数化、依赖注入），断言语句更直观（直接用assert），夹具（fixture）功能能优雅地管理测试前置和后置条件（如初始化driver）。它是目前Python测试领域的事实框架。

• 报告系统：Allure

  • 理由：生成的HTML报告交互性强，颜值高，能清晰展示测试套件、用例、步骤层级，并方便地附加截图和日志。对于需要向项目经理或产品经理展示测试结果的场景，Allure报告比简单的控制台输出或HTMLTestRunner生成的报告要专业得多。

• 项目管理与依赖管理：Poetry

  • 理由：比传统的requirements.txt加virtualenv方式更现代。它能同时处理依赖声明、虚拟环境管理和打包发布，锁定依赖版本，确保环境一致性。对于团队协作项目，强烈推荐使用。

注意：技术选型没有银弹。如果你的团队对Node.js更熟悉，完全可以使用JavaScript/TypeScript + Playwright 或 WebDriverIO。核心在于理解分层架构和POM模式，这些思想是通用的。

3. 环境搭建与核心组件配置

让我们开始动手搭建环境。我将以macOS/Linux系统为例，Windows用户只需注意路径和命令的微小差异。

3.1 使用Poetry初始化项目并管理依赖

首先，确保系统已安装Python 3.8+。然后安装Poetry。

# 安装Poetry curl -sSL https://install.python-poetry.org | python3 - # 创建项目目录并初始化 mkdir ecommerce-auto-framework && cd ecommerce-auto-framework poetry init -n # -n 跳过交互式问答，使用默认配置 # 添加核心依赖 poetry add selenium pytest pytest-xdist allure-pytest pytest-html poetry add python-dotenv # 用于管理环境变量 poetry add faker # 用于生成假数据 poetry add webdriver-manager # 自动管理浏览器驱动，强烈推荐！

pyproject.toml文件现在应该包含了所有依赖。使用poetry install安装它们，并自动创建虚拟环境。

为什么用webdriver-manager？传统方式需要手动下载与浏览器版本匹配的ChromeDriver或GeckoDriver，非常麻烦且容易出错。webdriver-manager会在运行时自动检测本地浏览器版本并下载匹配的驱动，极大简化了环境配置。

3.2 设计项目目录结构

一个清晰的结构是框架可维护性的基础。这是我推荐的结构：

ecommerce-auto-framework/ ├── pyproject.toml ├── poetry.lock ├── .env.example # 环境变量示例文件 ├── .gitignore ├── conftest.py # Pytest全局配置文件，定义fixture ├── pytest.ini # Pytest运行配置 │ ├── configs/ # 配置文件 │ ├── __init__.py │ ├── settings.py # 读取配置的主文件 │ └── dev_config.yaml # 环境相关配置（开发/测试/生产） │ ├── pages/ # 页面对象层 │ ├── __init__.py │ ├── base_page.py # 所有页面对象的基类 │ ├── login_page.py │ ├── home_page.py │ ├── product_page.py │ └── cart_page.py │ ├── tests/ # 测试用例层 │ ├── __init__.py │ ├── conftest.py # 测试目录特定的fixture │ ├── test_login.py │ ├── test_cart.py │ └── test_checkout.py │ ├── data/ # 测试数据层 │ ├── test_users.json │ └── products.csv │ ├── utils/ # 工具层 │ ├── __init__.py │ ├── driver_manager.py # 驱动管理核心 │ ├── logger.py # 日志配置 │ └── helpers.py # 通用辅助函数 │ ├── reports/ # 测试报告输出目录（.gitignore） │ └── allure-results/ # Allure原始结果 │ └── logs/ # 日志文件目录（.gitignore）

3.3 核心：封装Driver管理（utils/driver_manager.py）

这是框架最关键的部件之一。我们在这里创建、配置并返回WebDriver实例。

# utils/driver_manager.py import logging from selenium import webdriver from selenium.webdriver.chrome.service import Service as ChromeService from selenium.webdriver.firefox.service import Service as FirefoxService from webdriver_manager.chrome import ChromeDriverManager from webdriver_manager.firefox import GeckoDriverManager from configs.settings import BROWSER, HEADLESS, IMPLICITLY_WAIT, WINDOW_SIZE logger = logging.getLogger(__name__) class DriverManager: """管理WebDriver的生命周期""" @staticmethod def create_driver(): """根据配置创建并返回WebDriver实例""" driver = None try: if BROWSER.lower() == "chrome": options = webdriver.ChromeOptions() if HEADLESS: options.add_argument("--headless=new") # Selenium 4.11+ 推荐写法 options.add_argument("--no-sandbox") options.add_argument("--disable-dev-shm-usage") options.add_argument(f"--window-size={WINDOW_SIZE}") # 自动下载和管理ChromeDriver service = ChromeService(ChromeDriverManager().install()) driver = webdriver.Chrome(service=service, options=options) elif BROWSER.lower() == "firefox": options = webdriver.FirefoxOptions() if HEADLESS: options.add_argument("--headless") # 自动下载和管理GeckoDriver service = FirefoxService(GeckoDriverManager().install()) driver = webdriver.Firefox(service=service, options=options) else: raise ValueError(f"不支持的浏览器类型: {BROWSER}") # 设置隐式等待（全局等待策略） driver.implicitly_wait(IMPLICITLY_WAIT) logger.info(f"成功创建 {BROWSER} WebDriver实例 (无头模式: {HEADLESS})") return driver except Exception as e: logger.error(f"创建WebDriver失败: {e}") raise @staticmethod def quit_driver(driver): """安全退出Driver""" if driver: try: driver.quit() logger.info("WebDriver已退出") except Exception as e: logger.warning(f"退出WebDriver时发生异常: {e}")

关键点解析：

1. 使用webdriver-manager：彻底告别手动下载和配置驱动路径的烦恼，实现环境“开箱即用”。
2. 无头模式（Headless）：在CI/CD管道或不需要观察UI的测试中，使用无头模式可以节省资源，运行更快。--headless=new是Chrome较新版本更稳定的无头模式。
3. 浏览器选项：--no-sandbox和--disable-dev-shm-usage是解决在Docker或某些Linux环境中运行Chrome常见问题的经典参数。
4. 隐式等待：设置一个全局的等待时间，让WebDriver在查找元素时，如果元素没有立即出现，会轮询等待一段时间。这比硬编码time.sleep()要高效和可靠得多。

3.4 配置管理（configs/settings.py）

将配置外部化，便于不同环境（开发、测试、生产）切换。

# configs/settings.py import os from pathlib import Path from dotenv import load_dotenv # 加载.env文件中的环境变量 env_path = Path('.') / '.env' load_dotenv(dotenv_path=env_path) # 基础配置 BASE_URL = os.getenv("BASE_URL", "https://www.your-ecommerce-site.com") # 从环境变量读取，默认值 BROWSER = os.getenv("BROWSER", "chrome").lower() HEADLESS = os.getenv("HEADLESS", "false").lower() == "true" IMPLICITLY_WAIT = int(os.getenv("IMPLICITLY_WAIT", "10")) # 秒 WINDOW_SIZE = os.getenv("WINDOW_SIZE", "1920,1080") # 测试用户凭证（敏感信息务必使用环境变量！） TEST_USERNAME = os.getenv("TEST_USERNAME") TEST_PASSWORD = os.getenv("TEST_PASSWORD") # 路径配置 PROJECT_ROOT = Path(__file__).parent.parent SCREENSHOT_DIR = PROJECT_ROOT / "reports" / "screenshots" LOG_DIR = PROJECT_ROOT / "logs" ALLURE_RESULTS_DIR = PROJECT_ROOT / "reports" / "allure-results" # 创建必要的目录 for directory in [SCREENSHOT_DIR, LOG_DIR, ALLURE_RESULTS_DIR]: directory.mkdir(parents=True, exist_ok=True)

对应的.env文件示例：

# .env BASE_URL=https://demo.ecommerce.com BROWSER=chrome HEADLESS=false IMPLICITLY_WAIT=10 WINDOW_SIZE=1920,1080 TEST_USERNAME=standard_user TEST_PASSWORD=secret_sauce

实操心得：密码等敏感信息绝对不要硬编码在代码或配置文件中。一定要通过.env文件（且加入.gitignore）或CI/CD系统的安全变量来管理。.env.example文件提交到仓库，用于说明需要哪些环境变量。

4. 实现Page Object Model（POM）与基础页面类

POM是UI自动化测试的黄金法则，它能极大提升代码的维护性。

4.1 基础页面类（pages/base_page.py）

所有具体页面类都将继承这个基类。它封装了最常用的Selenium操作，并加入了等待、日志和截图。

# pages/base_page.py import logging from datetime import datetime from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.common.exceptions import TimeoutException, StaleElementReferenceException from configs.settings import SCREENSHOT_DIR logger = logging.getLogger(__name__) class BasePage: """所有页面对象的基类""" def __init__(self, driver): self.driver = driver self.wait = WebDriverWait(driver, timeout=10, poll_frequency=0.5, ignored_exceptions=[StaleElementReferenceException]) def find_element(self, locator): """查找单个元素，加入显式等待""" logger.debug(f"正在查找元素: {locator}") try: element = self.wait.until(EC.presence_of_element_located(locator)) return element except TimeoutException: logger.error(f"元素查找超时: {locator}") self._take_screenshot("element_not_found") raise def click(self, locator): """点击元素""" element = self.find_element(locator) logger.info(f"点击元素: {locator}") element.click() def input_text(self, locator, text): """向输入框输入文本""" element = self.find_element(locator) logger.info(f"向元素 {locator} 输入文本: {text}") element.clear() element.send_keys(text) def get_text(self, locator): """获取元素的文本内容""" element = self.find_element(locator) text = element.text logger.debug(f"获取元素 {locator} 的文本: {text}") return text def is_element_visible(self, locator, timeout=5): """判断元素是否可见""" try: WebDriverWait(self.driver, timeout).until(EC.visibility_of_element_located(locator)) return True except TimeoutException: return False def _take_screenshot(self, name): """内部方法：截取屏幕截图""" timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") filename = f"{SCREENSHOT_DIR}/{name}_{timestamp}.png" self.driver.save_screenshot(str(filename)) logger.info(f"截图已保存至: {filename}") return filename

为什么用显式等待（WebDriverWait）？隐式等待是全局的，不够灵活。显式等待允许我们为某个特定操作指定等待条件（如元素可点击、可见、存在），更精确，能有效解决因网络延迟或动态加载导致的元素找不到的问题。ignored_exceptions参数可以忽略像StaleElementReferenceException（元素过时）这类在动态页面中常见的临时异常，让等待更健壮。

4.2 具体页面类示例：登录页面（pages/login_page.py）

现在，我们用POM模式来实现一个电商网站的登录页面。

# pages/login_page.py from selenium.webdriver.common.by import By from pages.base_page import BasePage class LoginPage(BasePage): """登录页面对象""" # 元素定位器（Locators） - 核心！使用By类 USERNAME_INPUT = (By.ID, "user-name") # 示例定位器，需替换为实际值 PASSWORD_INPUT = (By.ID, "password") LOGIN_BUTTON = (By.ID, "login-button") ERROR_MESSAGE = (By.CSS_SELECTOR, "[data-test='error']") def __init__(self, driver): super().__init__(driver) # 可以在这里添加页面特有的初始化逻辑，比如打开登录页 # self.driver.get(f"{BASE_URL}/login") def open(self): """打开登录页面""" self.driver.get(f"{BASE_URL}") # 假设首页即登录页或跳转 return self def login(self, username, password): """执行登录操作""" self.input_text(self.USERNAME_INPUT, username) self.input_text(self.PASSWORD_INPUT, password) self.click(self.LOGIN_BUTTON) # 登录后通常返回下一个页面对象，如首页 from pages.home_page import HomePage return HomePage(self.driver) def get_error_message(self): """获取登录错误提示信息""" if self.is_element_visible(self.ERROR_MESSAGE): return self.get_text(self.ERROR_MESSAGE) return None def is_login_page_displayed(self): """判断是否在登录页面""" return self.is_element_visible(self.LOGIN_BUTTON)

定位器策略心得：

• 优先级：ID > CSS Selector > XPath。ID通常最稳定、最快。CSS Selector性能好，语法简洁。XPath功能强大但性能稍差，且容易因DOM结构微小变动而失效，慎用。
• 绝对避免：使用包含索引（如div[3]）、文本内容（如//button[text()='Submit']，除非文本绝对稳定）或过长、复杂的XPath。它们极其脆弱。
• 与开发协作：争取让开发同学为关键测试元素添加稳定的属性，如># conftest.py (项目根目录) import pytest import logging from utils.driver_manager import DriverManager from utils.logger import setup_logger from configs.settings import ALLURE_RESULTS_DIR # 设置日志 setup_logger() @pytest.fixture(scope="function") # 每个测试函数执行一次 def driver(): """提供WebDriver实例，测试结束后自动清理""" driver_instance = None try: driver_instance = DriverManager.create_driver() yield driver_instance # 将driver实例传递给测试用例 finally: DriverManager.quit_driver(driver_instance) @pytest.fixture(scope="session") def base_url(): """提供基础URL""" from configs.settings import BASE_URL return BASE_URL # 可以定义更多fixture，如登录状态的用户 @pytest.fixture def logged_in_user(driver, base_url): """返回一个已登录的首页页面对象""" from pages.login_page import LoginPage login_page = LoginPage(driver) home_page = login_page.open().login("standard_user", "secret_sauce") yield home_page # 如果需要，可以在这里执行登出操作 # home_page.logout()

  scope参数详解：

  • function（默认）：每个测试函数运行一次。适合大多数需要独立环境的UI测试。
  • class：每个测试类运行一次。
  • module：每个.py文件运行一次。
  • session：整个测试会话（一次pytest命令）运行一次。适合配置类资源，如base_url。

  5.2 编写第一个测试用例（tests/test_login.py）

  # tests/test_login.py import pytest import logging from pages.login_page import LoginPage logger = logging.getLogger(__name__) class TestLogin: """登录功能测试集""" def test_login_with_valid_credentials(self, driver, base_url): """测试使用有效凭证登录""" login_page = LoginPage(driver) # 打开登录页并登录 home_page = login_page.open().login("standard_user", "secret_sauce") # 断言：验证登录成功，例如检查首页的某个特定元素是否出现 assert home_page.is_cart_icon_visible() == True, "登录后购物车图标应可见" logger.info("有效凭证登录测试通过") @pytest.mark.parametrize("username, password, expected_error", [ ("locked_out_user", "secret_sauce", "此用户已被锁定"), ("invalid_user", "secret_sauce", "用户名和密码不匹配"), ("standard_user", "", "密码为必填项"), ]) def test_login_with_invalid_credentials(self, driver, base_url, username, password, expected_error): """参数化测试：使用多种无效凭证登录""" login_page = LoginPage(driver) login_page.open() login_page.input_text(login_page.USERNAME_INPUT, username) login_page.input_text(login_page.PASSWORD_INPUT, password) login_page.click(login_page.LOGIN_BUTTON) # 断言：验证出现了正确的错误信息 actual_error = login_page.get_error_message() assert actual_error is not None, "应显示错误信息" assert expected_error in actual_error, f"错误信息应为'{expected_error}'，实际为'{actual_error}'" logger.info(f"无效凭证测试通过: {username}/{password}")

  测试设计要点：

  1. 用例独立性：每个测试用例应该能独立运行，不依赖其他用例的状态。function级别的driverfixture确保了这一点。
  2. 清晰的断言：断言信息要明确，失败时能清晰指出问题所在。
  3. 使用参数化：@pytest.mark.parametrize是数据驱动测试的利器，能用一个测试函数覆盖多组输入和预期输出，大大减少代码冗余。
  4. 日志记录：在关键步骤添加日志，方便失败时回溯执行过程。

  5.3 运行测试并生成报告

  配置pytest.ini文件来定义默认的运行选项。

  # pytest.ini [pytest] # 自动发现测试文件 testpaths = tests # 指定Python路径 pythonpath = . # 添加命令行选项别名 addopts = -v # 详细输出 --tb=short # 失败时显示简短的追溯信息 --strict-markers # 严格检查marker --alluredir=reports/allure-results # 指定Allure结果目录 # 定义markers，用于分类测试 markers = smoke: 冒烟测试 regression: 回归测试 slow: 慢速测试

  现在，可以运行测试了。

  # 进入Poetry虚拟环境 poetry shell # 运行所有测试 pytest # 运行特定标记的测试（如冒烟测试） pytest -m smoke # 运行特定文件中的测试 pytest tests/test_login.py # 使用多进程并行运行测试（显著提速，需pytest-xdist） pytest -n auto # auto会自动检测CPU核心数

  测试完成后，生成Allure报告：

  # 生成Allure HTML报告（需要先安装Allure命令行工具） allure generate reports/allure-results -o reports/allure-report --clean # 打开报告 allure open reports/allure-report

  6. 高级主题与实战技巧

  框架搭起来了，基础用例也能跑了。但要应对复杂的电商场景，还需要一些“高级装备”。

  6.1 处理弹窗、iframe和多窗口

  电商网站常有登录弹窗、广告iframe或支付时跳转到第三方页面。

  处理iframe：

  # 在BasePage中补充方法 def switch_to_iframe(self, locator): """切换到指定的iframe""" iframe_element = self.find_element(locator) self.driver.switch_to.frame(iframe_element) logger.info("已切换到iframe") def switch_to_default_content(self): """切回主文档""" self.driver.switch_to.default_content() logger.info("已切回主文档")

  处理多窗口/标签页：

  def switch_to_new_window(self, original_window): """切换到新打开的窗口""" for window_handle in self.driver.window_handles: if window_handle != original_window: self.driver.switch_to.window(window_handle) logger.info("已切换到新窗口") return raise Exception("未找到新窗口") # 使用示例 original_window = driver.current_window_handle # 点击一个会打开新窗口的链接 page.click(NEW_WINDOW_LINK) page.switch_to_new_window(original_window) # 在新窗口操作... # 操作完毕后关闭新窗口并切回 driver.close() driver.switch_to.window(original_window)

  6.2 等待策略进阶：自定义等待条件

  有时内置的等待条件不够用，比如需要等待某个元素的文本变成特定值。

  from selenium.webdriver.support.wait import WebDriverWait def wait_for_text_to_be_present_in_element(locator, text, timeout=10): """自定义等待：等待元素的文本包含指定内容""" def _predicate(driver): try: element_text = driver.find_element(*locator).text return text in element_text except StaleElementReferenceException: return False wait = WebDriverWait(self.driver, timeout) return wait.until(_predicate, f"元素{locator}的文本未在{timeout}秒内包含'{text}'")

  6.3 测试数据管理与数据驱动

  将测试数据与代码分离是良好实践。我们可以用JSON文件管理用户数据。

  // data/test_users.json { "valid_users": [ {"username": "standard_user", "password": "secret_sauce", "role": "customer"}, {"username": "performance_glitch_user", "password": "secret_sauce", "role": "customer"} ], "invalid_users": [ {"username": "locked_out_user", "password": "secret_sauce", "expected_error": "此用户已被锁定"}, {"username": "invalid", "password": "invalid", "expected_error": "用户名和密码不匹配"} ] }

  在测试中读取：

  import json import pytest def load_test_data(file_path, key): with open(file_path, 'r', encoding='utf-8') as f: data = json.load(f) return data.get(key, []) # 在测试中使用 @pytest.mark.parametrize("user", load_test_data("data/test_users.json", "valid_users")) def test_login_with_data_file(user): username = user["username"] password = user["password"] # ... 使用数据进行测试

  6.4 集成到CI/CD（以GitHub Actions为例）

  自动化测试只有集成到CI/CD流水线中，才能实现其最大价值——持续反馈。

  # .github/workflows/test.yml name: UI Automation Tests on: push: branches: [ main, develop ] pull_request: branches: [ main ] jobs: test: runs-on: ubuntu-latest strategy: matrix: browser: [chrome, firefox] # 矩阵测试，跨浏览器 steps: - uses: actions/checkout@v3 - name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.10' - name: Install system dependencies (for Chrome) run: | sudo apt-get update sudo apt-get install -y wget unzip libnss3 - name: Install Poetry run: pip install poetry - name: Install dependencies run: poetry install --no-interaction - name: Run UI Tests with ${{ matrix.browser }} env: BASE_URL: ${{ secrets.BASE_URL }} BROWSER: ${{ matrix.browser }} HEADLESS: true # CI环境中使用无头模式 TEST_USERNAME: ${{ secrets.TEST_USERNAME }} TEST_PASSWORD: ${{ secrets.TEST_PASSWORD }} run: | poetry run pytest -v --alluredir=reports/allure-results - name: Upload Allure results uses: actions/upload-artifact@v3 if: always() # 即使测试失败也上传结果 with: name: allure-results-${{ matrix.browser }} path: reports/allure-results/ retention-days: 7 # 可以添加一个单独的job来生成和部署Allure报告 report: needs: test runs-on: ubuntu-latest if: always() steps: - uses: actions/download-artifact@v3 with: path: all-results pattern: allure-results-* merge-multiple: true - name: Generate Allure Report uses: simple-elf/allure-report-action@master with: allure_results: all-results allure_report: allure-report gh_pages: gh-pages - name: Deploy report to GitHub Pages uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: allure-report

  7. 常见问题排查与性能优化

  即使框架完善，在实际运行中仍会遇到各种问题。这里记录一些高频问题的排查思路。

  7.1 元素定位失败（NoSuchElementException）

  这是最常见的问题。

  • 检查定位器：首先在浏览器开发者工具中手动用$()(CSS) 或$x()(XPath) 验证定位器是否正确。
  • 检查等待：元素是否还没加载出来？尝试增加隐式/显式等待时间，或使用更合适的等待条件（如element_to_be_clickable）。
  • 检查iframe/Shadow DOM：目标元素是否在iframe或Shadow DOM内部？需要先切换上下文。
  • 检查动态属性：元素的ID或Class是否是动态生成的？避免使用包含变化部分的定位器，尝试用更稳定的属性或CSS选择器。
  • 页面是否跳转/刷新：操作后页面发生了变化，之前的元素引用可能“过时”（StaleElementReferenceException）。需要重新查找元素。

  7.2 测试执行速度慢

  UI自动化本身就不快，但可以优化。

  • 使用无头模式（Headless）：在CI或不需要观察UI时，速度提升显著。
  • 并行执行（pytest-xdist）：利用pytest -n auto并行运行测试用例。注意：确保测试用例之间完全独立，不共享状态（如同一个用户账号）。
  • 优化等待：减少硬编码的time.sleep，使用智能的显式等待。但等待时间不宜设置过长。
  • 复用浏览器会话：对于一组关联的测试，可以考虑使用scope="class"或scope="module"的fixture来复用driver，但需仔细清理测试数据，避免状态污染。
  • 选择性运行：使用pytest的-k选项按名称过滤，或-m按标记运行，只运行必要的测试。

  7.3 测试在CI上不稳定（Flaky Tests）

  不稳定测试是自动化测试的毒瘤。

  • 根源：通常是异步加载、时间差、网络延迟或第三方依赖（如验证码、支付网关）导致的。
  • 对策：
    1. 加强等待：使用更鲁棒的等待策略，等待特定条件成立，而非固定时间。
    2. 重试机制：对不稳定的操作或断言进行重试。Pytest有插件如pytest-rerunfailures。
    3. 隔离外部依赖：使用Mock或Test Double来模拟不稳定的第三方服务。
    4. 截图和日志：在失败时自动截屏并保存详细的HTML页面源码和操作日志，这是事后分析的根本。
    5. 定期清理：识别并修复或删除那些始终不稳定的测试用例。

  7.4 如何应对UI频繁变化？

  这是POM模式要解决的核心问题。

  • 集中管理定位器：所有定位器都定义在页面对象类中，UI一变，只需修改对应的页面类。
  • 使用相对稳定的定位策略：优先选择ID、>