如何无需XSLT转换，通过简便方式修改pytest-bdd生成的JUnit XML测试名称以适配Jira XRay展示需求

要解决XRay测试项名称过于技术化的问题，不需要复杂的XSLT转换，我们可以直接在pytest层面修改测试用例的名称，让生成的JUnit XML报告直接包含友好的自然语言名称。以下是两种简便的实现方式：

方法1：使用pytest收集钩子修改测试名称 #

在项目根目录创建/修改conftest.py文件，添加pytest_collection_modifyitems钩子函数，它会在pytest收集完所有测试用例后执行，我们可以在这里替换测试项的名称：

def pytest_collection_modifyitems(items):
    for item in items:
        # 仅处理pytest-bdd生成的场景测试
        if hasattr(item, "scenario"):
            # 获取Feature文件中定义的场景名称（如"创建新用户"）
            base_name = item.scenario.name
            param_suffix = ""

            # 处理Scenario Outline的参数化情况
            if hasattr(item, "callspec"):
                param_values = list(item.callspec.params.values())
                if param_values:
                    # 根据参数数量生成后缀，单参数用[值]，多参数用[值1-值2]
                    if len(param_values) == 1:
                        param_suffix = f" [{param_values[0]}]"
                    else:
                        param_suffix = f" [{'-'.join(map(str, param_values))}]"

            # 替换测试用例的名称和nodeid（JUnit报告优先使用name属性）
            item.name = f"{base_name}{param_suffix}"
            # 可选：修改nodeid让pytest命令行输出也更友好
            item._nodeid = f"{item.nodeid.split('::')[0]}::{base_name}{param_suffix}"

方法2：自定义pytest-bdd场景名称生成钩子 #

pytest-bdd提供了pytest_bdd_scenario_name钩子，可以直接控制场景测试的名称生成逻辑，同样在conftest.py中添加：

def pytest_bdd_scenario_name(request, feature, scenario, step, step_index):
    # 基础名称为Feature中的场景名
    scenario_name = scenario.name

    # 处理参数化的Scenario Outline
    if hasattr(request, "param") and isinstance(request.param, dict):
        param_values = list(request.param.values())
        if param_values:
            scenario_name += f" [{'-'.join(map(str, param_values))}]"

    return scenario_name

效果验证 #

1. 运行你的测试命令（比如pytest --junitxml=reports/results.xml）生成JUnit报告
2. 打开results.xml，你会看到testcase的name属性已经变成了友好的名称，例如：

   <testcase classname="tests.step_defs.test_visitor_page" name="创建新用户[110-201]" time="1.125"/>
   

3. 再用你原来的cURL命令导入XRay，测试项的名称就会直接显示为“创建新用户[110-201]”这类自然语言格式，完全符合你的需求。

定制化扩展 #

如果需要更详细的参数展示（比如带上参数名），可以修改参数后缀的生成逻辑，例如：

param_str = f" [{', '.join([f'{k}={v}' for k, v in item.callspec.params.items()])}]"

这样生成的名称会是创建新用户 [locationId=110, returnCode=201]，更清晰展示参数信息。

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