如何在不修改测试代码的前提下通过pytest命令行或配置标记xfail用例

pytest 6.0及以上版本原生支持通过命令行参数直接标记指定测试为xfail，无需修改测试源码：

• 标记单个测试用例：pytest --xfail "test_module.py::test_target_func"
• 按通配符批量标记同规则测试：pytest --xfail "test_module.py::test_deprecated_*"
• 同时标记多个不同测试：pytest --xfail "test_a.py::test_x" --xfail "test_b.py::test_y"
  如果需要标记为严格xfail（测试意外通过时判定为执行失败），可以替换为--xfail-strict参数，用法完全一致。

如果需要固定一批测试长期标记为xfail，无需每次执行时加命令行参数，可以在项目根目录的pytest.ini中添加配置：

[tool:pytest]
xfail =
    test_api.py::test_old_interface
    test_pay.py::test_legacy_channel
    tests/legacy/*::test_*
# 严格xfail配置
xfail_strict =
    test_api.py::test_unfinished_feature

该配置会对所有pytest执行生效，适合固定的预期失败用例场景。

如果需要更灵活的自定义匹配规则（比如按测试目录、用例参数、自定义标记等批量标记），可以在conftest.py中通过pytest_collection_modifyitems钩子实现：

import pytest

def pytest_collection_modifyitems(config, items):
    # 示例规则1：所有legacy目录下的测试标记为xfail
    xfail_dirs = ["tests/legacy/"]
    # 示例规则2：测试名包含指定关键词的标记为xfail
    xfail_keywords = ["deprecated", "old_", "legacy_"]

    for item in items:
        if any(dir_path in str(item.fspath) for dir_path in xfail_dirs):
            item.add_marker(pytest.mark.xfail(reason="旧版遗留功能，预期失败", strict=False))
        if any(keyword in item.name for keyword in xfail_keywords):
            item.add_marker(pytest.mark.xfail(reason="已废弃功能，预期失败", strict=False))

该方案灵活性最高，可以满足任意复杂的批量标记需求。

注意：--xfail命令行参数和pytest.ini中的xfail配置项仅在pytest 6.0及以上版本可用，低版本pytest仅可通过conftest.py钩子方案实现

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