如何在pytest的teardown fixture中正确标记测试失败？

直接用pytest的pytest_runtest_makereport钩子，在测试结果生成前介入修改，避免产生重复的测试条目。

具体实现 #

在项目根目录的conftest.py中添加以下代码：

def pytest_runtest_makereport(item, call):
    # 仅在测试执行阶段（call phase）处理结果
    if call.when == "call":
        # 获取测试用例实例（针对类中的测试方法）
        test_instance = item.instance
        # 检查实例是否有自定义的失败判断方法
        if hasattr(test_instance, "actually_failed") and test_instance.actually_failed():
            # 强制将测试结果标记为失败，替换原有的PASS状态
            call.excinfo = (AssertionError, AssertionError("测试实际执行失败"), None)
            call.outcome = "failed"

为什么这个方案有效 #

• 原来的autouse fixture方案中，yield后的代码是在测试主逻辑已经被pytest标记为PASS之后执行的，此时抛出异常会被pytest识别为独立的清理阶段错误，因此生成两条结果。
• 而pytest_runtest_makereport钩子是在测试执行完成、最终报告生成之前触发的，直接修改测试的执行结果和异常信息，pytest只会生成一条正确的失败记录。

备选方案优化（装饰器方式） #

如果坚持用装饰器，也可以避免重复条目，示例如下：

import pytest

def check_actual_failure(func):
    def wrapper(self, *args, **kwargs):
        func(self, *args, **kwargs)
        if self.actually_failed():
            pytest.fail("测试实际执行失败")
    return wrapper

之后可以用sed批量给测试方法添加装饰器，但钩子方案无需修改现有测试代码，更适合大量测试的场景。

内容的提问来源于stack exchange，提问作者Leggy