如何配置pytest，在测试用例缺失assert语句时触发失败或告警？

完全理解你的痛点——那些看起来有验证逻辑但实际没加assert的测试，简直是隐形的坑，运行全绿但根本没起到验证作用。幸运的是，我们可以通过自定义pytest钩子或者简单配置来解决这个问题，下面给你两种实用方案：

方案1：自定义pytest插件（灵活可控） #

我们可以编写一个本地的pytest插件，通过分析测试函数的AST（抽象语法树）来检查是否存在断言逻辑，包括assert语句、pytest.raises上下文管理器，甚至常用的断言助手函数（比如assert_equal）。

步骤1：创建conftest.py文件 #

在你的项目根目录下创建conftest.py，添加以下代码：

import ast
import pytest

def _has_valid_assertion(node):
    """检查节点是否包含有效断言逻辑"""
    for n in ast.walk(node):
        # 检测直接的assert语句
        if isinstance(n, ast.Assert):
            return True
        # 检测pytest.raises调用
        if isinstance(n, ast.Call):
            if (isinstance(n.func, ast.Attribute) 
                and n.func.attr == 'raises' 
                and getattr(n.func.value, 'id', '') == 'pytest'):
                return True
            # 检测unittest风格的断言助手
            if isinstance(n.func, ast.Name) and n.func.id in [
                'assert_equal', 'assert_true', 'assert_false',
                'assert_not_equal', 'assert_in', 'assert_not_in'
            ]:
                return True
    return False

def pytest_collection_modifyitems(session, config, items):
    # 读取命令行参数，控制是否强制失败
    fail_on_no_assert = config.getoption("--fail-on-no-assert", default=False)
    
    for item in items:
        # 跳过标记为允许无断言的测试
        if item.get_closest_marker("allow_no_assert"):
            continue
        
        # 解析测试函数的AST
        try:
            tree = ast.parse(item.function.__code__.co_code.decode())
        except Exception:
            # 处理无法解析的情况（比如动态生成的函数）
            continue
        
        if not _has_valid_assertion(tree):
            msg = f"⚠️ 测试用例 {item.nodeid} 未包含任何有效断言（缺少assert、pytest.raises或断言助手调用）"
            if fail_on_no_assert:
                # 标记为强制失败
                item.add_marker(pytest.mark.xfail(reason=msg, strict=True))
            else:
                # 仅发出警告
                config.warn("W001", msg, nodeid=item.nodeid)

# 添加命令行选项
def pytest_addoption(parser):
    parser.addoption(
        "--fail-on-no-assert",
        action="store_true",
        default=False,
        help="强制让无断言的测试用例失败"
    )

步骤2：配置与使用 #

• 仅警告模式：直接运行pytest，无断言的测试会通过但会在输出中显示警告。
• 强制失败模式：运行pytest --fail-on-no-assert，无断言的测试会直接标记为失败。
• 例外情况：如果有些测试确实不需要断言（比如仅验证函数不抛出异常），可以给测试添加标记：

  @pytest.mark.allow_no_assert
  def test_safe_function_execution():
      safe_function()
  

方案2：使用第三方插件（快速上手） #

如果你不想自己写代码，可以尝试pytest-empty-test插件，它可以检测无任何操作的测试用例，包括无断言的情况。

安装与使用 #

pip install pytest-empty-test

运行时添加参数：

pytest --empty-test-fail

不过这个插件的检测逻辑相对简单，可能无法识别pytest.raises这类间接断言，所以如果你的测试中有这类场景，方案1会更可靠。

关键说明 #

针对你提到的mock_http_request.call_args[1]['deadline'] == 5这种情况：Python会执行这个表达式，但不会验证结果，测试会直接通过。通过上面的方案，这类测试会被检测出来——因为AST中没有assert节点，会触发警告或失败，帮你及时修复这类无效测试。

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