如何防止 pytest 运行父测试类中的测试用例-Python教程-PHP中文网

如何防止 pytest 运行父测试类中的测试用例

在使用模板方法模式组织 pytest 测试时，需确保子类（如 child1–child3）正常运行继承的测试，而父类（parent）本身不被实例化、不执行任何测试，且不导致失败或冗余收集。本文提供可靠、符合 pytest 机制的解决方案。

在使用模板方法模式组织 pytest 测试时，需确保子类（如 child1–child3）正常运行继承的测试，而父类（parent）本身不被实例化、不执行任何测试，且不导致失败或冗余收集。本文提供可靠、符合 pytest 机制的解决方案。

在 pytest 中直接继承 unittest.TestCase 的多层测试类结构（如 Parent → Child1/2/3）会带来一个典型问题：pytest 默认会收集并尝试运行所有符合命名规则（如 test_*）的测试方法，包括定义在抽象父类中的方法；而若将父类设为抽象类或设置 __test__ = False，又会导致子类测试无法被识别——这是因为 pytest 的收集器依赖类的继承链与可实例化性，而非仅靠属性标记。

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

最健壮、无副作用的解法是分离逻辑复用与测试框架绑定：让父类不再继承 unittest.TestCase，仅作为纯逻辑容器；子类则通过多重继承，先继承父类（获取测试方法），再继承 unittest.TestCase（获得 pytest 兼容性）：

# 纯逻辑基类 —— 不继承 TestCase，不被 pytest 收集
class Parent:
    def setUp(self):
        # 公共初始化逻辑（pytest 中建议改用 fixture，此处为兼容 unittest 风格）
        pass

    def test_authentication_flow(self):
        # 模板测试方法，依赖子类实现抽象行为
        self._perform_login()
        assert self.is_authenticated()

    def _perform_login(self):
        raise NotImplementedError("子类必须实现 _perform_login")

    def is_authenticated(self):
        raise NotImplementedError("子类必须实现 is_authenticated")


# 具体测试类 —— 多重继承：Parent 在前，TestCase 在后！
class Child1(Parent, unittest.TestCase):
    def _perform_login(self):
        self.session = "child1_session"

    def is_authenticated(self):
        return hasattr(self, 'session')


class Child2(Parent, unittest.TestCase):
    def _perform_login(self):
        self.token = "child2_token"

    def is_authenticated(self):
        return hasattr(self, 'token')

⚠️ 关键细节：Child1(Parent, unittest.TestCase) 中 Parent 必须排在 unittest.TestCase 之前。这是因为 Python 方法解析顺序（MRO）决定了 setUp、test_* 等方法优先从 Parent 查找；若顺序颠倒，unittest.TestCase 的默认行为（如空 setUp）可能覆盖父类逻辑，且 pytest 可能因未识别到有效测试主体而跳过。

❌ 不推荐的替代方案（及其缺陷）

以下方法虽能“绕过”问题，但存在明显缺陷，仅作对比参考：

在父类中用 if type(self) == Parent: return 跳过测试体
→ 导致每个子类实例仍会收集并运行父类的全部测试方法（例如 4 个父测试 + 3 个子类 ⇒ 实际运行 4×3 = 12 次重复测试），严重污染测试报告和耗时。
在父类中抛异常模拟抽象方法但允许 type(self) == Parent 时静默返回
→ 父类自身仍会被实例化（pytest 会尝试创建 Parent() 实例），一旦 Parent 出现在测试路径中（如显式指定模块），即触发 TypeError 或 NotImplementedError，导致测试失败。
设置 Parent.__test__ = False
→ pytest 会递归忽略该类及其所有子类（因 __test__ 属性被继承），导致 Child1 等完全不被收集。

✅ 最佳实践补充建议

若项目已全面采用 pytest（而非混合 unittest），更推荐用 fixture + 参数化 替代模板方法模式：

@pytest.fixture(params=["child1_config", "child2_config"])
def auth_context(request):
    if request.param == "child1_config":
        return {"session": "s1"}
    return {"token": "t2"}

def test_authentication_flow(auth_context):
    # 逻辑内聚，无需继承
    assert "session" in auth_context or "token" in auth_context

对于必须保留 unittest 风格的场景，请始终验证 pytest 收集结果：
```
python -m pytest --collect-only test_module.py
```
确保输出中仅出现 Child1.test_*、Child2.test_* 等条目，*绝无 `Parent.test_`**。