Pytest Subtests实战：彻底告终断言阻塞，测试效率倍增

在编写自动化测试时，你是否遇到过这种“闹心”事：一个测试用例里需要校验 10 项数据，结果 第 1 项校验失败，整个用例就直接报错跳出了。剩下的 9 项到底对不对？不知道，得改完第一个再测。

以前我们要么忍受这种低效，要么写一堆复杂的 @pytest.mark.parametrize。但现在，Pytest 9.0+ 已经原生内置了 subtests 功能！它能让你在一个用例里跑多个“子测试”，互不干扰。

1. 什么是 Subtests？

subtests 是一种逻辑上的“用例分组”。它允许你在一个测试函数内部，运行多个独立的断言块。

核心特性：

• 独立执行：某个子测试失败，后续的子测试依然会继续执行。
• 聚合报告：在一个测试用例下汇总所有失败点。
• 动态生成：支持在循环或逻辑分支中动态创建，比参数化更灵活。

2. 使用示例

使用 subtests 无需安装额外插件（Pytest 9.0+），直接在函数参数中引入同名 fixture 即可。

基础代码示例

假设我们要测试一个接口返回的多个字段，不希望因为 name 错了就导致没测 age。

import pytest

def test_user_data_logic(subtests):
    user_info = {
        "name": "hogwarts",
        "age": 18,
        "email": "invalid-email", # 假设这是个错误数据
        "status": "active"
    }

    for key, value in user_info.items():
        # 使用 with 语句开启子测试
        # msg: 自定义描述信息；后面可以跟任意数量的关键字参数（如 field=key）用于标识数据
        with subtests.test(msg=f"校验字段: {key}", field=key):
            if key == "email":
                assert"@"in value
            elif key == "age":
                assert value >= 18
            else:
                assert value isnotNone

运行效果展示
当你运行上面的代码，你会看到类似下方的输出：

__________________ test_user_data_logic [校验字段: email] __________________
subtests = <_pytest.subtests.Subtests object at 0x...>
def test_user_data_logic(subtests):
    ...
>   assert "@" in value
E   AssertionError: assert '@' in 'invalid-email'

__________________________ test_user_data_logic ___________________________
contains 1 failed subtest
========================= short test summary info =========================
FAILED test_demo.py::test_user_data_logic - contains 1 failed subtest

即使 email 校验失败了，status 的校验依然被执行了,报告会清晰地告诉你哪个子测试（msg 或 field）出了问题。

4. 深度对比：Subtests vs 参数化

很多小伙伴会纠结：我用 @pytest.mark.parametrize 不也能达到类似效果吗？

5. 进阶技巧

A. 控制详细输出

默认情况下，Pytest 只显示失败的子测试。如果你想在控制台看到所有（包括成功）的子测试进度，请使用 -v 参数：pytest -v test_demo.py

B. 类型提示 (Typing)

如果你追求代码规范，可以为 subtests 加上类型注解，方便 IDE 进行补全：

import pytest

def test_with_typing(subtests: pytest.Subtests):
    with subtests.test():
        assert True

C. 旧版本兼容

如果你还在用 Pytest 8.x 或更早的版本，只需要手动安装插件即可拥有同样功能：pip install pytest-subtests

6. 避坑指南 & 最佳实践

1. 不要滥用：不要把整个系统的测试都塞进一个函数里。Subtests 应该用于校验同一逻辑实体的不同属性。
2. 异常处理：如果代码在 with subtests.test(): 块之外抛出了异常（比如数据库连接失败），测试依然会立刻终止。
3. 数据隔离：由于所有子测试共享同一个测试函数的作用域，注意不要让上一个子测试修改了下一个子测试要用的变量。

结语

subtests 的引入补全了 Pytest 在“细粒度断言”上的短板。它既保留了单个用例的简洁，又提供了多点校验的韧性。

你觉得这个功能好用吗？或者在实际项目中遇到了哪些坑？欢迎在评论区交流讨论！ 🚀