如何防止 pytest 自动执行父测试类中的测试方法-Python教程-PHP中文网

如何防止 pytest 自动执行父测试类中的测试方法

在使用模板方法模式组织 unittest 测试时，若父类继承自 unittest.TestCase，pytest 会错误地收集并尝试运行父类中的测试方法，导致失败或冗余执行；本文提供可靠且符合 pytest 收集机制的解决方案——采用复合继承（Parent 先于 TestCase 继承），并解释其原理与关键细节。

在使用模板方法模式组织 unittest 测试时，若父类继承自 `unittest.testcase`，pytest 会错误地收集并尝试运行父类中的测试方法，导致失败或冗余执行；本文提供可靠且符合 pytest 收集机制的解决方案——采用复合继承（parent 先于 testcase 继承），并解释其原理与关键细节。

当采用模板方法模式构建测试类层级（如 Parent → Child1/Child2/Child3）时，核心诉求是：复用父类中定义的通用测试逻辑，但禁止 pytest 执行父类自身实例化的测试。由于项目已通过 python_classes= 在 pytest.ini 中锁定类名匹配规则，无法依赖命名约定（如 *Test 或 Test*）过滤，因此必须从类设计层面解决。

✅ 推荐方案：复合继承（Composition via Multiple Inheritance）

最健壮、零副作用的解法是剥离父类对 unittest.TestCase 的直接继承，改用多重继承，并确保 Parent 类排在 unittest.TestCase 之前：

# 纯逻辑基类：不继承 TestCase
class Parent:
    def setUp(self):
        # 公共初始化逻辑（pytest 会自动调用，因子类是 TestCase）
        pass

    def tearDown(self):
        # 公共清理逻辑
        pass

    def test_authentication_flow(self):
        # 通用测试逻辑，依赖子类实现抽象行为
        self._perform_login()
        self.assertTrue(self.is_authenticated())

    def _perform_login(self):
        raise NotImplementedError("子类必须实现登录逻辑")

# 具体测试类：继承顺序至关重要 — Parent 必须在前！
class Child1(Parent, unittest.TestCase):
    def _perform_login(self):
        # Child1 特定实现
        self.session = "child1_session"

class Child2(Parent, unittest.TestCase):
    def _perform_login(self):
        self.session = "child2_session"

⚠️ 关键点：class Child1(Parent, unittest.TestCase) 中 Parent 必须位于 unittest.TestCase 之前。这是因为 pytest（及 unittest）通过 isinstance(obj, unittest.TestCase) 判断是否为测试类，而 Python MRO（方法解析顺序）决定了 setUp/tearDown 和测试方法能否被正确识别和调用。若顺序颠倒（如 unittest.TestCase, Parent），Parent 中的方法将无法被 TestCase 机制识别，导致 setUp 不执行、测试方法丢失。

此方案优势显著：

父类 Parent 不再是 unittest.TestCase 子类，完全不会被 pytest 收集为测试类；
所有子类既是 Parent 的实例（获得共享逻辑），又是 unittest.TestCase 的合法子类（被正常收集、运行）；
无冗余测试、无失败标记、无需修改配置或跳过逻辑。

❌ 不推荐的替代方案（附风险说明）

若因历史原因难以重构继承结构，可考虑以下变通方式，但均有明显缺陷：

在父类测试方法中动态跳过：
```
class Parent(unittest.TestCase):
    def test_something(self):
        if type(self) is Parent:
            self.skipTest("Parent 是抽象基类，不直接运行")
        # 实际测试逻辑...
```
问题：pytest 仍会为每个子类 重复收集 父类的每个测试（例如 3 个子类 × 4 个父测试 = 12 条用例），造成报告冗余与执行开销。
抽象方法防御性返回：
```
def abstract_setup(self):
    if type(self) is Parent:
        return  # 静默退出
    raise NotImplementedError()
```
问题：违反测试可观察性原则，隐藏逻辑分支，不利于调试与维护；且未解决父类被收集的问题。

总结

方案	是否被 pytest 收集父类？	是否产生冗余用例？	可维护性	推荐度
复合继承（Parent + TestCase）	❌ 否	❌ 否	✅ 高（清晰分离职责）	⭐⭐⭐⭐⭐
`if type(self) == Parent: return`	✅ 是	✅ 是	❌ 低（隐式控制流）	⚠️ 仅作临时兼容
`__test__ = False`（类级）	❌ 否	✅ 是（子类测试失效）	❌ 无效	❌ 禁用