pytest的pytest_runtest_makereport钩子通过判断report.when == "call"且not report.passed来精准捕获失败用例,避免误捕setup/teardown异常;应使用report.longreprtext获取堆栈,弃用已废弃的report.outcome。
pytest的pytest_runtest_makereport钩子怎么捕获失败用例
这个钩子是获取测试结果最直接的方式,它在每个测试项执行完后触发,返回一个
对象。关键不是等所有测试跑完再汇总,而是每跑完一个用例就立刻拿到它的状态——
、
、
都是布尔值,但要注意:失败(fail)和报错(error)都走
分支;而 setup/teardown 阶段出问题则对应
或
。
常见错误是只判断
,漏掉
条件,导致 setup 失败也被当成用例失败发通知;或者把
当成可靠字段,其实它在 pytest 7+ 已被弃用,应以
/
/
为准。
只在
时处理用例执行结果,跳过 setup/teardown
用
不对,正确写法是
用
取完整 traceback,比
更稳定(后者依赖
)
飞书
机器人 Webhook 怎么发带格式的测试摘要消息
飞书卡片消息比纯文本更易读,但官方 Python SDK 对卡片 schema 支持弱,直接用
构造 JSON 更可控。重点在于
设为
,然后在
字段里组织元素:标题用
,失败用例列表用
+
+
,错误堆栈建议折叠(
),避免刷屏。
容易踩的坑是忽略飞书对卡片字段长度限制:单个
超过 2000 字会截断,堆栈过长必须截取关键行(比如最后 5 行 +
);另外 Webhook URL 必须带
和
签名(如果启用了安全设置),否则返回
错误。
立即学习
“
Python免费学习笔记(深入)
”;
飞书aily
飞书旗下 AI 智能伙伴 与企业 Agent 开发平台
下载
构造请求头:
错误信息截断示例:
签名计算需用
+
,密钥来自飞书机器人后台,不可硬编码在代码里
如何避免重复发送或干扰正常 pytest 输出
钩子函数本身不阻塞 pytest 流程,但发网络请求可能超时或失败,必须加异常捕获;更重要的是,不能让通知逻辑影响 pytest 的退出码——即使飞书发送失败,测试本身成功也该返回 0。另一个问题是并发执行(
)下多个 worker 同时调用钩子,会导致同一用例被多次通知。
根本解法是只在主进程发通知:通过
判断是否为主节点(
或检查
是否为空),非主进程跳过所有通知逻辑。
用
包裹飞书请求,记录 warning 日志但不抛出
在
中设全局标记:
,后续钩子里先检查该标记
不要在
里汇总发送——它拿不到单个用例的
,且 session 级异常无法区分是测试失败还是环境问题
本地调试时怎么模拟失败用例又不真发飞书
硬编码开关(如
)太粗糙,容易提交到 CI;推荐用 pytest 的
自定义命令行参数,配合
注册。这样本地跑时加
就跳过发送,CI 环境才填真实 URL。
调试阶段最实用的是把消息内容打到 stdout 或写入临时文件,而不是发出去。注意别用
,会被 pytest 捕获进日志,改用
或
配合
。
注册参数:
在钩子中判断:
消息体打印示例:
飞书通知真正难的不是发消息,而是准确识别“谁该被通知”“什么时候该停”——比如 CI 中某个用例因环境不稳定偶发失败,连续三次都发提醒反而让人忽略真问题。这需要额外加失败重试计数或按标签过滤,但那是另一层逻辑了。
TestReportreport.passedreport.failedreport.skippedreport.when == "call""setup""teardown"report.failedreport.when == "call"report.outcomereport.passedreport.failedreport.skippedreport.when == "call"report.failed or report.failednot report.passed and report.when == "call"report.longreprtextreport.caplog--log-cli-levelrequests.postmsg_type"interactive"cardheaderelementsdivtexttag: "collapse"text.content"... (truncated)"timestampsign400{"Content-Type": "application/json; charset=utf-8"}report.longreprtext.splitlines()[-5:] if report.longreprtext else []hmac.newbase64.b64encode-n autopytest_configureconfig.option.numprocesses is Noneos.environ.get("PYTEST_XDIST_WORKER")try/except requests.RequestExceptionpytest_configureconfig._lark_notifier_enabled = is_masterpytest_sessionfinishlongreprtextif os.getenv("NOTIFY_LARK") == "1"--lark-webhookaddoption--lark-webhook=noneprint()sys.stderr.write()logging.getLogger("lark").info()--log-cli-level=INFOparser.addoption("--lark-webhook", action="store", default=None)if webhook_url and webhook_url != "none": send_to_lark(...)logging.getLogger("lark").debug(f"Would send: {json.dumps(card, ensure_ascii=False)[:200]}...")