📚 课程目录第2章提取通用基类夹具

第2章：提取通用基类夹具

本章介绍如何通过创建抽象基类夹具（Abstract Base Fixture）来消除UI测试中的重复初始化代码。核心思路是将所有测试类共享的公共初始化逻辑（如浏览器启动、用户登录、页面对象注入等）上移到基类中，子类仅需继承并实现差异化内容。这种模式遵循“组合优于继承”的变体，能够显著降低维护成本，提高测试可读性。

2.1 原理：抽象基类夹具的设计模式

在UI测试中，每个测试类通常需要重复编写setUp()方法，包括创建WebDriver实例、设置隐式等待、初始化页面对象、加载测试环境地址等。通过提取一个抽象的BaseTest基类，可以将这些公共操作集中管理，子类只需关注自身特有的配置（如不同的用户角色、测试数据或页面导航）。

抽象基类夹具遵循以下设计原则：

封装性：公共初始化细节封装在基类的setUp()模板方法中，子类不可随意覆写基类核心流程。
可扩展性：子类通过钩子方法（如beforeTest()、afterTest()）插入自定义行为，避免破坏继承链。
隔离性：每个测试类的实例变量（如页面对象）在基类中统一创建，子类通过getDriver()、getLoginPage()等受保护方法访问。

2.2 实现流程

识别公共初始化步骤：分析现有所有测试类的setUp()和tearDown()，提取重复部分（浏览器配置、驱动创建、页面对象实例化、环境URL等）。
创建抽象基类：定义BaseTest类，标注为抽象类，将公共逻辑写入setUp()模板方法，并声明抽象方法（如getTestUser()）供子类实现。
编写受保护访问器：提供getDriver()、getPageObject()等方法，确保子类能安全访问基类资源。
子类继承并实现：每个具体测试类继承BaseTest，仅需实现抽象方法或覆写钩子方法，不再重复编写驱动初始化代码。

提示：在大型测试套件中，建议将基类的setUp()方法标记为final（如Java中的final或Python中的双下划线约定），防止子类无意中覆盖核心逻辑。

2.3 代码示例：抽象基类与子类继承

以下使用Python + pytest + Selenium实现。基类BaseTest封装了Chrome驱动创建、隐式等待和页面对象注入，子类TestLogin仅需实现get_user_role()并编写测试用例。

import pytest
from selenium import webdriver
from abc import ABC, abstractmethod

class BaseTest(ABC):
    driver = None
    page = None

    @abstractmethod
    def get_user_role(self):
        """每个子类必须返回用户角色字符串"""
        pass

    def setup_method(self, method):
        # 公共初始化逻辑
        self.driver = webdriver.Chrome()
        self.driver.implicitly_wait(10)
        self.driver.get("https://example.com/login")
        # 页面对象由子类传入或工厂创建
        self.page = self.create_page_object(self.driver)

    def create_page_object(self, driver):
        # 基类提供默认页面对象工厂，子类可重写
        from pages.login_page import LoginPage
        return LoginPage(driver)

    def teardown_method(self, method):
        if self.driver:
            self.driver.quit()

    def get_driver(self):
        return self.driver

# 子类继承复用
class TestLogin(BaseTest):
    def get_user_role(self):
        return "admin"

    def test_successful_login(self):
        self.page.enter_credentials("admin", "password")
        self.page.click_login()
        assert "Dashboard" in self.driver.title

2.4 调试与部署

基类夹具的调试重点在于验证继承链是否完整，以及子类是否意外覆盖了关键资源。常见调式手段：

打印初始化状态：在基类setup_method中添加print(f"BaseTest: driver created, session={self.driver.session_id}")。
使用异常断言：在基类teardown_method中捕获异常并打印堆栈，确保driver.quit()在子类失败时仍被调用。
部署前检查：在CI流水线中执行pytest --collect-only，验证所有测试类能被正确收集且没有抽象方法未实现。

2.5 常见错误与解决方案

错误场景	原因	解决方案
子类无法访问基类driver	driver被设为私有属性	改用受保护属性（如`self._driver`）或提供getter方法
多个子类共享同一WebDriver实例导致竞态	基类使用了类变量而非实例变量	将`driver`初始化为实例变量（在`setup_method`中赋值）
抽象方法未实现导致收集错误	忘记继承并实现抽象方法	IDE中启用抽象方法检查，或添加`@abstractmethod`装饰器
基类setup中抛出异常，子类teardown未执行	异常发生在资源创建后	使用try-finally块保护teardown调用，或使用pytest的`with_fixture`

2.6 性能与稳定性优化

基类夹具的滥用可能导致测试套件性能下降，以下优化策略可缓解：

懒加载页面对象：不要在基类setUp()中创建所有可能用到的页面对象，改为在子类通过工厂方法按需创建。
连接池复用：如果使用远程WebDriver或Docker节点，基类可以封装连接管理，避免每个测试重复创建连接。
资源清理保障：在基类的teardown方法中使用try/finally确保driver被关闭，防止泄漏。

  稳定性建议：在基类的setup_method中添加显式等待替代implicitly_wait，减少网络波动导致的定位失败。例如：WebDriverWait(self.driver, 10).until(lambda d: d.title != "")。

2.7 小结

提取通用基类夹具是UI测试代码复用最直接有效的手段。通过将公共初始化逻辑上移到抽象基类，子类代码量可减少60%以上，且修改公共行为时只需改动基类一处，避免逐一调整所有测试文件。实践中应警惕继承过深导致的调试困难，建议基类层级不超过两层，并配合依赖注入或组合模式处理复杂场景。