使用Pytest生成测试报告：HTML与Allure集成指南
生成HTML格式测试报告
在自动化测试中，生成直观、可读性强的测试报告是不可或缺的一环。Pytest 提供了多种插件支持报告生成，其中 pytest-testreport 是一个轻量且易于使用的选项，可用于快速生成美观的 HTML 报告。
安装与配置
首先通过 pip 安装该插件：
pip install pytest-testreport
注意：若系统中已安装
pytest-html，建议先卸载以避免命令或输出冲突。
运行参数说明
使用以下命令行参数来自定义报告内容：
- --report：指定输出的 HTML 文件名
- --title：设置报告主标题
- --tester：填写测试执行人姓名
- --desc：描述项目或测试背景信息
- --template：选择界面模板（支持模板1和模板2）
命令行调用示例
pytest --report=report_output.html --title="自动化测试结果" --tester="QA Team" --desc="用户登录模块验证" --template=2
代码中调用 pytest.main
也可在 Python 脚本中直接触发执行：
import pytest
if __name__ == "__main__":
pytest.main([
"--report=results.html",
"--title=回归测试报告",
"--tester=张伟",
"--desc=核心功能冒烟测试",
"--template=1"
])
报告样式预览
插件提供两种视觉风格：
- 模板1：简洁经典布局
- 模板2：现代扁平化设计
集成 Allure 生成高级测试报告
Allure 是一款功能强大的测试报告框架，支持丰富的交互式图表、步骤追踪和失败分析能力。结合 allure-pytest 插件，可以深度整合至 Pytest 测试流程中。
环境准备
- 下载 Allure 命令行工具：
- 访问 GitHub 发布页 下载对应操作系统的版本
- 配置环境变量：
- 将解压后的
allure-x.x/bin目录添加到系统 PATH 中
- 将解压后的
- 安装 Python 端插件：
pip install allure-pytest
生成原始数据
运行测试时使用 --alluredir 指定输出目录，Allure 将生成 JSON 格式的中间数据文件：
pytest --alluredir=./output/allure-results
或在代码中启动：
import pytest
pytest.main(["--alluredir", "./output/allure-results"])
启动可视化服务
执行以下命令启动本地服务器并自动打开浏览器查看报告：
allure serve ./output/allure-results
此命令会临时生成静态页面并监听端口，便于实时查看测试结果。
常用 Allure 注解增强报告可读性
设置用例标题
使用 @allure.title 自定义测试用例显示名称：
import allure
import pytest
class TestUserLogin:
@allure.title("正常流程 - 用户成功登录")
def test_valid_credentials(self):
assert True
动态命名参数化用例
对于参数化场景，可通过 allure.dynamic.title() 实现运行时命名：
@pytest.mark.parametrize("case", [
{"scenario": "密码错误", "input": ("user", "wrong")},
{"scenario": "账户不存在", "input": ("unknown", "pass")}
])
def test_login_failure_cases(case):
# 动态更新报告中的用例名称
allure.dynamic.title(f"异常场景：{case['scenario']}")
# 模拟断言失败
assert False, "模拟登录失败"
组织功能模块结构
使用 @allure.story 和 @allure.suite 对测试进行逻辑分组：
@allure.suite("用户认证模块")
@allure.feature("登录功能")
class TestAuthentication:
@allure.story("短信验证码登录")
def test_login_with_otp(self):
pass
@allure.story("用户名密码登录")
def test_login_with_password(self):
pass
附加失败截图
捕获关键证据提升调试效率：
import allure
def capture_failure_screenshot(driver, path):
driver.save_screenshot(path)
with open(path, "rb") as image_file:
content = image_file.read()
allure.attach(content, name="错误截图", attachment_type=allure.attachment_type.PNG)
通常在 fixture 的 teardown 阶段或异常处理中调用该方法。
