如何移除pytest中请求超时失败时的超长Traceback？

我太懂你这种烦恼了——当多个依赖同一个fixture的测试因为超时失败时，满屏的栈追踪直接把有用的提示淹没了，完全没法高效排查问题。咱们来逐个解决这个问题：

为什么会出现超长Traceback？ #

你之前在fixture里捕获requests.exceptions.Timeout后抛出SystemExit，但pytest默认会捕获这个异常并打印完整的调用栈。而且每个依赖该fixture的测试都会触发一次这个栈追踪，20个测试失败的话输出直接爆炸。设置sys.tracebacklimit=None没用，是因为pytest有自己的异常处理逻辑，不会受这个全局设置影响。

解决方案一：用pytest内置的失败/跳过方法替代SystemExit #

这是最直接的方式，不用抛系统级异常，而是用pytest提供的pytest.fail()或者pytest.skip()来终止测试，同时可以直接禁用Traceback：

import pytest
import requests

@pytest.fixture(scope="session")
def api_client():
    try:
        # 你的请求逻辑
        response = requests.get("https://your-api-url.com", timeout=2)
        response.raise_for_status()
        return response
    except requests.exceptions.Timeout:
        # pytrace=False 直接关闭该失败的Traceback输出
        pytest.fail("API请求超时，终止相关测试", pytrace=False)

这样每个测试失败时只会显示你设置的提示语，不会有冗长的栈追踪，多个测试失败的输出也会清晰很多。

解决方案二：自定义pytest异常钩子（针对全局场景） #

如果你需要更灵活的控制，比如只针对超时相关的异常隐藏Traceback，可以在项目根目录的conftest.py里添加自定义的异常处理钩子：

# conftest.py
import requests

def pytest_exception_interact(node, call, report):
    # 检查异常链中是否包含请求超时异常
    exc_chain = call.excinfo.traceback
    has_timeout = any(
        isinstance(exc.value, requests.exceptions.Timeout)
        for exc in exc_chain
    )
    # 如果是超时导致的失败，清除长Traceback
    if has_timeout:
        report.longrepr = None
        report.shortrepr = "⚠️ 请求超时，测试终止"

这个钩子会在pytest处理异常时触发，自动识别超时相关的失败，替换成简洁的提示。

解决方案三：全局限制Traceback输出（快速临时方案） #

如果想快速全局关闭或缩短Traceback，可以在运行pytest时加命令行参数：

• pytest --tb=no：完全关闭所有Traceback
• pytest --tb=short：只显示简短的栈追踪
• pytest --tb=line：每个失败只显示一行提示

也可以把配置写到pytest.ini里永久生效：

[pytest]
addopts = --tb=short

不过这个是全局生效的，如果你需要保留其他异常的Traceback，还是前两个方案更合适。

总结 #

最推荐的是方案一，既精准控制超时场景的输出，又能保持其他异常的正常Traceback；如果需要全局统一处理超时异常，方案二更灵活。

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