使用pytest在多测试模块共享验证器时的断言详情缺失问题

问题原因 #

pytest默认仅对测试模块（文件名以test_开头）启用断言重写机制，该机制会增强assert语句，在失败时自动显示预期值与实际值的对比。你把验证逻辑放到了utils.py（非测试模块）中，导致其中的assert语句未被pytest增强，因此失败时仅显示基础的AssertionError。

可行解决方案 #

方案1：注册断言重写 #

在项目根目录的conftest.py中添加以下代码，让pytest对utils.py模块开启断言重写：

import pytest
# 替换为你的utils模块的完整路径，比如如果utils和测试模块同目录，直接写"utils"
pytest.register_assert_rewrite("utils")

修改后，utils里的assert语句会被pytest增强，测试失败时会自动显示预期/实际值的对比，和内联代码的错误信息完全一致。

方案2：自定义断言错误消息 #

直接修改utils.py中的verify方法，给assert语句添加自定义错误消息，无需依赖pytest的断言重写：

def verify(self, line_1: str, line_2: str):
    # Lots of comparisons based on internal state ...
    assert line_1 == "Hello, World", f"Expected: 'Hello, World'\nActual: '{line_1}'"
    assert line_2 == "Goodbye, World", f"Expected: 'Goodbye, World'\nActual: '{line_2}'"

这种方法更直观，即使没有pytest的增强，也能清晰看到失败原因，且不需要额外配置。

方案3：基于参数化的通用测试模板 #

如果所有测试的结构高度一致，可以将通用测试逻辑封装为模板，在各测试模块中通过参数化复用：

1. 在utils.py中定义通用测试函数：

def run_verification(verifier, line_1, line_2):
    verifier.verify(line_1, line_2)

2. 在test_a.py中参数化调用：

import pytest
from .utils import verifier, run_verification

@pytest.mark.parametrize("line_1, line_2", [
    ('*A XYZ                                                     %', '*A XYZ                                                       %')
])
def test_a_essential(verifier, line_1, line_2):
    run_verification(verifier, line_1, line_2)

该方案需配合方案1或2使用，才能获得详细错误信息，但能进一步减少测试模块的重复代码。

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