如何在pytest-bdd中正确使用@pytest.mark.xfail标记？

数据老陈

2026-9-30

问题原因

pytest的标记是作用于测试用例函数层级，你将@pytest.mark.xfail添加在单个step定义函数上不会生效，pytest-bdd会为每个Scenario自动生成独立的测试用例函数，标记需要绑定到这个生成的测试用例上才会生效。

解决方法

方法1：在feature文件中添加tag（最便捷）

直接在对应Scenario上方添加@xfail标签，pytest-bdd会自动将feature文件中的标签映射为pytest的标记：

@xfail
Scenario: Validate the API response where availableLicense should not be greater than the totalLicense.
Given Send valid input
Then validate the availableLicense count should not be greater than totalLicense.

如果需要配置xfail的参数（比如设置严格模式、添加原因），可以在pytest配置文件中对xfail标签做自定义映射，或者使用方法2。

方法2：在Python代码中给Scenario绑定标记

在定义Scenario对应的测试函数时，直接添加@pytest.mark.xfail装饰器即可，step定义不需要做任何修改：

import pytest
from pytest_bdd import scenario, given, then

# 给对应Scenario的测试函数加xfail标记
@pytest.mark.xfail(reason="已知许可证计数逻辑待修复，预期校验失败", strict=False)
@scenario("example.feature", "Validate the API response where availableLicense should not be greater than the totalLicense.")
def test_validate_license_count():
    pass

# 原step定义保持不变，不需要加xfail装饰器
@given('Send valid input')
def valid_data(context, url,token_url, api_key):
    context.response = api_req('get',url, token_url, api_key)

@then('validate the availableLicense count should not be greater than totalLicense.')
def validate_license_count(context):
      <some logic>
      assert avail_license <= total_license

补充说明