在使用模板方法模式组织 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_`**。
综上，采用「复合继承」（class Child(Parent, unittest.TestCase)）是兼顾代码复用、pytest 兼容性与测试清晰性的最优解——它让父类彻底退出测试生命周期，只承担契约与逻辑职责，真正实现“可继承、不可运行”。
