如何让pytest工厂夹具内的错误按夹具错误而非测试失败上报？

我在pytest中使用“工厂作为夹具（factory as fixture）”模式时，遇到了一个令人困扰的错误上报问题：当工厂函数内部发生错误时，pytest将其报告为测试失败，而非夹具设置错误。

我采用了pytest官方文档中描述的“工厂作为夹具”模式：

@pytest.fixture
def make_customer_record():
    def _make_customer_record(name):
        # 此处若出错，会被报告为测试失败
        record = models.Customer(name=name, orders=[])
        return record

    return _make_customer_record


def test_customer_records(make_customer_record):
    # 错误会在此处被上报
    customer_1 = make_customer_record("Lisa")
    customer_2 = make_customer_record("Mike")
    customer_3 = make_customer_record("Meredith")

当_make_customer_record内部抛出异常时，错误会在调用工厂的测试代码行被上报，而非作为夹具设置错误。

是否有办法让夹具返回的工厂函数抛出的错误被报告为夹具错误而非测试失败？类似假想的pytest.error()函数的功能就很理想。

具体来说，我希望测试报告显示：

ERROR tests/test_hello_world.py::test_hello_world

而非当前显示的：

FAILED tests/test_hello_world.py::test_hello_world

我希望工厂函数中的错误能像直接在夹具内抛出的异常一样，被作为设置错误上报，而非测试失败。这能让测试报告更清晰，区分实际测试失败与基础设施/设置问题。

pytest文档仅介绍了工厂夹具的使用方法，未提及该错误上报问题的解决方案。

要实现这个需求，核心思路是通过自定义异常标记工厂内的错误，再利用pytest的钩子函数修改测试报告结果，将其从测试失败转为夹具错误。

步骤1：定义自定义异常 #

创建专属异常，用于区分工厂夹具错误和普通测试逻辑错误：

class FactoryFixtureError(Exception):
    """标记工厂夹具内部的设置错误"""
    pass

步骤2：修改工厂夹具抛出自定义异常 #

更新工厂夹具，捕获内部异常并转换为自定义异常抛出：

import pytest

@pytest.fixture
def make_customer_record():
    def _make_customer_record(name):
        try:
            record = models.Customer(name=name, orders=[])
            return record
        except Exception as e:
            # 包装原始异常，保留堆栈信息
            raise FactoryFixtureError(f"工厂夹具执行失败: {str(e)}") from e
    return _make_customer_record

步骤3：添加钩子函数修改测试报告 #

在项目的conftest.py文件中添加pytest_runtest_makereport钩子，识别自定义异常并修改报告结果：

import pytest

@pytest.hookimpl(tryfirst=True)
def pytest_runtest_makereport(item, call):
    # 仅处理测试执行阶段的异常
    if call.when == "call" and call.excinfo is not None:
        # 判断是否是工厂夹具的自定义异常
        if isinstance(call.excinfo.value, FactoryFixtureError):
            report = call.get_result()
            # 将测试结果从FAILED改为ERROR
            report.outcome = "error"
            # 更新报告详情，明确标记为夹具错误
            report.longrepr = f"[夹具工厂错误] {call.excinfo.value}"

效果验证 #

当工厂内部出现错误时，测试报告将显示ERROR而非FAILED，清晰区分测试逻辑失败和基础设施/夹具设置类错误。

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