Pytest钩子发飞书通知，测试结果实时提醒

本文深入解析了如何利用 pytest 的 `pytest_runtest_makereport` 钩子精准捕获测试失败用例，并实时通过飞书机器人推送结构化通知——不仅厘清了易被忽视的关键细节（如必须结合 `report.when == "call"` 判断执行阶段、弃用已废弃的 `report.outcome`、优先使用 `report.longreprtext` 获取可靠堆栈），还手把手教你绕过飞书卡片消息的诸多坑（长度截断、签名计算、并发重复发送），并提供生产就绪的工程实践：主进程隔离通知、优雅异常处理、命令行动态开关与本地调试方案，真正让测试失败提醒既准确、稳定又不干扰开发流程。

pytest的pytest_runtest_makereport钩子怎么捕获失败用例

这个钩子是获取测试结果最直接的方式，它在每个测试项执行完后触发，返回一个 TestReport 对象。关键不是等所有测试跑完再汇总，而是每跑完一个用例就立刻拿到它的状态——report.passed、report.failed、report.skipped 都是布尔值，但要注意：失败（fail）和报错（error）都走 report.when == "call" 分支；而 setup/teardown 阶段出问题则对应 "setup" 或 "teardown"。

常见错误是只判断 report.failed，漏掉 report.when == "call" 条件，导致 setup 失败也被当成用例失败发通知；或者把 report.outcome 当成可靠字段，其实它在 pytest 7+ 已被弃用，应以 report.passed/report.failed/report.skipped 为准。

• 只在 report.when == "call" 时处理用例执行结果，跳过 setup/teardown
• 用 report.failed or report.failed 不对，正确写法是 not report.passed and report.when == "call"
• 用 report.longreprtext 取完整 traceback，比 report.caplog 更稳定（后者依赖 --log-cli-level）

飞书机器人 Webhook 怎么发带格式的测试摘要消息

飞书卡片消息比纯文本更易读，但官方 Python SDK 对卡片 schema 支持弱，直接用 requests.post 构造 JSON 更可控。重点在于 msg_type 设为 "interactive"，然后在 card 字段里组织元素：标题用 header，失败用例列表用 elements + div + text，错误堆栈建议折叠（tag: "collapse"），避免刷屏。

容易踩的坑是忽略飞书对卡片字段长度限制：单个 text.content 超过 2000 字会截断，堆栈过长必须截取关键行（比如最后 5 行 + "... (truncated)"）；另外 Webhook URL 必须带 timestamp 和 sign 签名（如果启用了安全设置），否则返回 400 错误。

• 构造请求头：{"Content-Type": "application/json; charset=utf-8"}
• 错误信息截断示例：report.longreprtext.splitlines()[-5:] if report.longreprtext else []
• 签名计算需用 hmac.new + base64.b64encode，密钥来自飞书机器人后台，不可硬编码在代码里

如何避免重复发送或干扰正常 pytest 输出

钩子函数本身不阻塞 pytest 流程，但发网络请求可能超时或失败，必须加异常捕获；更重要的是，不能让通知逻辑影响 pytest 的退出码——即使飞书发送失败，测试本身成功也该返回 0。另一个问题是并发执行（-n auto）下多个 worker 同时调用钩子，会导致同一用例被多次通知。

根本解法是只在主进程发通知：通过 pytest_configure 判断是否为主节点（config.option.numprocesses is None 或检查 os.environ.get("PYTEST_XDIST_WORKER") 是否为空），非主进程跳过所有通知逻辑。

• 用 try/except requests.RequestException 包裹飞书请求，记录 warning 日志但不抛出
• 在 pytest_configure 中设全局标记：config._lark_notifier_enabled = is_master，后续钩子里先检查该标记
• 不要在 pytest_sessionfinish 里汇总发送——它拿不到单个用例的 longreprtext，且 session 级异常无法区分是测试失败还是环境问题

本地调试时怎么模拟失败用例又不真发飞书

硬编码开关（如 if os.getenv("NOTIFY_LARK") == "1"）太粗糙，容易提交到 CI；推荐用 pytest 的 --lark-webhook 自定义命令行参数，配合 addoption 注册。这样本地跑时加 --lark-webhook=none 就跳过发送，CI 环境才填真实 URL。

调试阶段最实用的是把消息内容打到 stdout 或写入临时文件，而不是发出去。注意别用 print()，会被 pytest 捕获进日志，改用 sys.stderr.write() 或 logging.getLogger("lark").info() 配合 --log-cli-level=INFO。

• 注册参数：parser.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]}...")

飞书通知真正难的不是发消息，而是准确识别“谁该被通知”“什么时候该停”——比如 CI 中某个用例因环境不稳定偶发失败，连续三次都发提醒反而让人忽略真问题。这需要额外加失败重试计数或按标签过滤，但那是另一层逻辑了。

终于介绍完啦！小伙伴们，这篇关于《Pytest钩子发飞书通知，测试结果实时提醒》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！