Pytest集成JUnitXML问题：如何添加测试信息、Jira关联及步骤

一、先搞定基础JUnitXML报告生成 #

运行测试时，通过命令行参数指定生成JUnitXML报告：

pytest --junitxml=test_report.xml

或者在项目根目录的pytest.ini里配置默认生成，避免每次输命令：

[pytest]
junitxml = test_report.xml

二、添加测试套件、用例名称与Jira工单关联 #

1. 设置测试套件名称 #

如果要给整个模块的测试用例统一设置套件名，用自动生效的模块级fixture：

import pytest

@pytest.fixture(scope="module", autouse=True)
def set_suite_name(record_xml_attribute):
    # 给当前模块下所有用例添加套件名属性
    record_xml_attribute("suite_name", "登录功能测试套件")

2. 单个用例的名称与Jira关联 #

在测试用例里直接调用record_xml_attribute添加自定义属性：

def test_login_success(record_xml_attribute):
    # 覆盖默认用例名，设置更友好的名称
    record_xml_attribute("name", "验证正确账号登录成功")
    # 添加Jira工单关联
    record_xml_attribute("jira_ticket", "PROJ-789")
    
    # 测试逻辑...
    assert True

三、记录测试步骤到JUnitXML #

JUnitXML原生没有「步骤」节点，但可以通过record_property把步骤信息作为自定义属性写入。推荐两种方式：

方式1：逐个记录步骤 #

每个步骤对应一个record_property调用，键名按顺序命名：

def test_login_success(record_property, record_xml_attribute):
    # 先设置基础属性
    record_xml_attribute("name", "验证正确账号登录成功")
    record_xml_attribute("jira_ticket", "PROJ-789")

    # 记录步骤1：输入用户名
    record_property("step_1", "输入用户名：test_user")
    # 执行输入操作...

    # 记录步骤2：输入密码
    record_property("step_2", "输入密码：******")
    # 执行输入操作...

    # 记录步骤3：点击登录按钮
    record_property("step_3", "点击登录按钮")
    # 执行点击操作...

    # 记录步骤4：验证登录结果
    record_property("step_4", "验证页面跳转至首页")
    # 执行验证逻辑
    assert True

方式2：结构化批量记录 #

如果步骤较多，可把步骤打包成JSON字符串，用单个属性记录：

import json

def test_login_success(record_property, record_xml_attribute):
    test_steps = [
        "输入用户名：test_user",
        "输入密码：******",
        "点击登录按钮",
        "验证跳转至首页"
    ]
    # 把步骤列表转为JSON字符串存入
    record_property("test_steps", json.dumps(test_steps))

    # 基础属性设置
    record_xml_attribute("name", "验证正确账号登录成功")
    record_xml_attribute("jira_ticket", "PROJ-789")
    
    # 测试逻辑...
    assert True

四、你的原有代码问题修正 #

你之前的代码里，record_xml_attribute('CLICK STEP', '1st step')是给用例添加了一个不规范的属性名，而非步骤记录；record_property("1st step", "clicking")的键名也不利于后续解析。改成上面的步骤记录方式，就能在生成的JUnitXML里看到清晰的步骤信息了。

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