如何优雅地为pytest测试项附加运行时信息用于报告？

核心思路 #

利用Python的contextvars模块实现跨调用栈的测试项（item）访问，配合自动生效的fixture完成测试项的自动绑定，无需手动在函数间传递item实例。同时配置pytest-html插件从item.stash中读取数据生成自定义报告列。

实现步骤 #

1. 定义上下文变量存储当前测试项 #

在conftest.py中创建全局上下文变量，用于在测试执行周期内保存当前的pytest.Item实例：

# conftest.py
import contextvars
import pytest

# 定义上下文变量，默认值为None
current_test_item = contextvars.ContextVar("current_test_item", default=None)

2. 编写自动绑定测试项的fixture #

添加一个自动生效（autouse=True）的fixture，在测试开始时绑定当前测试项到上下文变量，测试结束后清理：

# conftest.py
@pytest.fixture(autouse=True)
def bind_test_item(request):
    # 将当前测试项写入上下文变量，保存token用于后续重置
    token = current_test_item.set(request.item)
    yield
    # 测试用例执行完毕后重置上下文变量
    current_test_item.reset(token)

3. 在任意函数中存储运行时数据 #

不管是测试函数本身，还是深层嵌套的工具函数、接口请求函数，都可以直接通过上下文变量获取测试项，将运行时数据存入item.stash：

示例接口请求工具函数：

# utils/api_client.py
from conftest import current_test_item
import requests

def send_api_request(url):
    response = requests.get(url)
    # 获取当前测试项实例
    item = current_test_item.get()
    if item:
        # 将响应状态码存入item.stash
        item.stash["response_status"] = response.status_code
    return response

测试用例中直接调用工具函数即可：

# test_api.py
from utils.api_client import send_api_request

def test_example_api():
    response = send_api_request("https://example.com")
    assert response.status_code == 200

4. 配置pytest-html展示自定义列 #

在conftest.py中添加钩子函数，把item.stash中的数据展示到测试报告的自定义列中：

# conftest.py
def pytest_html_report_title(report):
    report.title = "API自动化测试报告"

def pytest_html_results_table_header(cells):
    # 在报告表格中插入自定义列头
    cells.insert(2, "<th>响应状态码</th>")

def pytest_html_results_table_row(report, cells):
    # 从item.stash中读取数据填充列，无数据时显示N/A
    status_code = report.item.stash.get("response_status", "N/A")
    cells.insert(2, f"<td>{status_code}</td>")

优势说明 #

• 无需手动传递测试项实例，深层函数可直接访问，代码结构更简洁
• 采用item.stash存储数据符合pytest官方扩展规范，避免污染测试项的其他属性
• 自动fixture确保每个测试用例独立绑定上下文，不会出现数据串扰问题

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