如何在pytest中捕获KeyError后标记测试失败，无需抛出SystemExit

AI 小北

2026-5-29

How to Make pytest Fail on KeyError Without Raising SystemExit?

嘿，这个问题其实很好解决，核心就是让pytest感知到KeyError的发生——毕竟pytest默认会把未捕获的异常直接判定为测试失败，你只需要调整你的异常处理逻辑就行，给你几个实用的方案：

方案1：直接移除异常捕获逻辑

如果这个KeyError本身就意味着测试不通过，那完全没必要捕获它。修改后的代码如下：

def test_foo():
    dict = load_dict()
    value = dict[foo][bar]

这样当foo或者bar不存在时，KeyError会直接抛出来，pytest会自动捕获这个未处理的异常，标记测试失败，同时输出完整的回溯信息，完全符合你的需求。

方案2：捕获后重新抛出异常

如果你需要在捕获异常时做一些额外操作（比如打印提示信息），那捕获后重新抛出异常就可以了，这样pytest依然能检测到异常并判定测试失败：

def test_foo():
    dict = load_dict()
    try:
        value = dict[foo][bar]
    except KeyError:
        print('missing foo or bar')
        raise  # 不带参数的raise会原样抛出捕获的KeyError

这个方法既保留了你想要的提示输出，又能让pytest识别到异常，完美兼顾两种需求。

方案3：使用pytest内置的`pytest.fail()`主动触发失败

如果你想自定义失败提示语，或者更明确地告知pytest“这里测试失败了”，可以用pytest提供的pytest.fail()函数：

import pytest

def test_foo():
    dict = load_dict()
    try:
        value = dict[foo][bar]
    except KeyError:
        pytest.fail("Test failed: missing 'foo' or 'bar' in the loaded dictionary")

调用这个函数后，pytest会直接标记测试失败，并且显示你自定义的提示信息，可读性更强。