如何使pytest软断言失败时在Allure报告中标记为Broken类别？

一、实现软断言失败后标记为Allure Broken状态 #

你当前的代码之所以仍显示为Failed，是因为pytest_check默认会在测试结束时自动抛出AssertionError，覆盖了你手动抛出的KeyError。要解决这个问题，需要禁用pytest_check的自动断言抛出逻辑，手动收集失败后再抛出KeyError：

import pytest
from pytest_check import check

def test_custom_assertions():
    # 禁用pytest_check自动抛出AssertionError的默认行为
    check.disable()
    
    x = 25
    y = 21

    # 执行软断言，失败不会中断测试
    check.equal(x, 23, "x is not equal to 23")
    check.greater(y, 20, "y is not greater than 20")
    check.is_in(30, [10, 20, 25], "30 is not in the list")
    
    # 获取所有软断言失败的信息
    failures = check.get_failures()
    if failures:
        # 拼接失败信息，抛出KeyError让Allure标记为Broken
        error_details = "\n".join(str(failure) for failure in failures)
        raise KeyError(f"业务逻辑校验失败：\n{error_details}")

关键说明： #

• check.disable()：关闭pytest_check在测试结束时自动抛出AssertionError的机制
• check.get_failures()：获取所有软断言的失败记录，方便自定义错误信息
• 手动抛出KeyError：触发Allure的Broken状态标记

二、测试分类逻辑的合理性与优化建议 #

现有分类的合理性 #

你的分类逻辑：

• Broken：流程走完但存在计算类小问题
• Failed：依赖不可用等无法继续执行的情况

这个定义是合理的，核心是区分「测试能完整执行但业务逻辑不符」和「测试无法正常执行」两种场景，只要团队内部统一认知，就能有效提升报告的可读性。

优化方向 #

1. 结合Allure标签增强区分度
   可以给不同类型的测试添加自定义标签，方便在报告中快速筛选统计：

   import allure
   
   @allure.tag("业务校验")
   def test_custom_assertions():
       # ... 测试代码 ...
       
   @allure.tag("依赖校验")
   def test_dependency_availability():
       # 检查依赖服务是否可用，不可用时抛出AssertionError
       if not is_service_alive():
           raise AssertionError("依赖服务不可用，测试终止")
   

2. 统一异常类型映射
   如果需要更严格的状态区分，可以在conftest.py中通过pytest钩子自定义异常与Allure状态的映射：

   import pytest
   from _pytest.outcomes import Failed, Broken
   
   def pytest_runtest_makereport(item, call):
       if call.excinfo is not None:
           # 自定义规则：依赖类异常标记为Failed
           if call.excinfo.type in [ConnectionError, TimeoutError]:
               call.excinfo.type = Failed
               call.excinfo.value = Failed(str(call.excinfo.value))
           # 业务校验异常标记为Broken
           elif call.excinfo.type == KeyError:
               call.excinfo.type = Broken
               call.excinfo.value = Broken(str(call.excinfo.value))
   

这样无需手动调整抛出的异常类型，就能按照团队规则自动标记测试状态。

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