如何在测试Testament类时避免PytestCollectionWarning（附示例）

首先得明确触发警告的原因：pytest默认会自动收集所有名称以Test开头的类作为测试类，你的Testament类刚好符合这个命名规则，所以pytest会尝试去收集它，但这个类是业务类而非测试类，里面没有以test_开头的测试方法，因此会抛出PytestCollectionWarning。

下面是几种仅针对该模块抑制此警告的解决方案，不用全局关闭所有警告：

方案1：修改业务类命名（最简单直接） #

把Testament类的名字改成不以Test开头的名称，比如Will或者TestamentModel。这样pytest就不会把它识别为待收集的测试类，自然不会触发警告。

修改后的testament.py：

class Will():
    def __init__(self, name):
        self.name = name
    def check(self):
        return True

方案2：给业务类添加nottest标记 #

如果不能修改类名，可以在Testament类上添加@pytest.mark.nottest装饰器，明确告诉pytest不要把这个类当作测试类来收集。

修改后的testament.py：

import pytest

@pytest.mark.nottest
class Testament():
    def __init__(self, name):
        self.name = name
    def check(self):
        return True

方案3：通过pytest配置文件精准过滤警告 #

在项目根目录创建或修改pytest的配置文件（比如pytest.ini、tox.ini或pyproject.toml），添加规则仅忽略testament.testament模块的PytestCollectionWarning。

用pytest.ini的示例： #

[pytest]
filterwarnings =
    ignore::pytest.PytestCollectionWarning:testament.testament

用pyproject.toml的示例： #

[tool.pytest.ini_options]
filterwarnings = [
    "ignore::pytest.PytestCollectionWarning:testament.testament",
]

这种方法不需要修改业务代码，适合不想改动原代码的场景。

方案4：通过conftest.py自定义警告过滤逻辑 #

如果需要更灵活的控制，可以在项目根目录创建conftest.py文件，添加钩子函数来过滤特定警告：

import pytest

def pytest_warning_capture(record):
    # 仅忽略testament.testament模块中的PytestCollectionWarning
    if (
        record.category == pytest.PytestCollectionWarning
        and record.filename.endswith("testament.py")
    ):
        return False  # 返回False表示不捕获该警告，即抑制它

这样就能精准控制只抑制目标模块的特定警告，其他警告正常显示。

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