一文带你掌握Python pytest的前后置处理机制与方法

 更新时间:2026年04月16日 09:17:32   作者:Lightning-py  
pytest 提供了多种灵活的前置(setup)和后置(teardown)处理机制,从简单的函数级到复杂的模块/会话级,下面小编就和大家详细介绍一下,希望对大家有所帮

在 pytest 中,确保后置清理代码一定会执行(无论测试通过、失败还是发生异常),推荐使用以下两种最稳健的方式:

1. 使用yield的 fixture(推荐)

在 fixture 的 yield 之后编写清理代码,pytest 会在测试结束后自动运行这些代码,即使测试断言失败或抛出异常。

import pytest
@pytest.fixture
def db_connection():
    # 前置:建立连接
    conn = create_connection()
    yield conn
    # 后置:一定会执行(除非 fixture 前置阶段就挂了)
    conn.close()
def test_query(db_connection):
    assert db_connection.query("SELECT 1") == 1

注意:如果 yield 之前的代码(建立连接)抛出了异常,那么 yield 之后的清理代码不会执行,因为 fixture 本身没有成功初始化。这是合理的——资源从未被成功获取,自然无需释放。

2. 使用request.addfinalizer

功能与 yield 类似,但以注册回调函数的方式显式声明清理逻辑。

import pytest
@pytest.fixture
def db_connection(request):
    conn = create_connection()
    def cleanup():
        conn.close()
    request.addfinalizer(cleanup)   # 注册后置函数
    return conn

同样,addfinalizer 注册成功后的清理函数一定会执行。

3. 在测试类或模块中使用传统teardown方法

适用于经典的 xUnit 风格,pytest 完全支持:

方法级def teardown_method(self, method):

类级def teardown_class(cls):

模块级def teardown_module(module):

class TestDatabase:
    def setup_method(self):
        self.conn = create_connection()
    def teardown_method(self):
        self.conn.close()   # 每个测试方法结束后一定会执行
    def test_query(self):
        assert self.conn.query("SELECT 1") == 1

4. 如果需要“无论如何(即使 fixture 设置失败)都执行清理”

如果存在必须执行的全局资源回收(例如临时文件、进程等),可以在 fixture 中使用 try/finally

@pytest.fixture
def temp_file():
    f = None
    try:
        f = open("/tmp/test.txt", "w")
        yield f
    finally:
        if f:
            f.close()
        # 或者无条件删除文件

但这种情况较少见,因为通常设置失败时资源尚未分配,无需清理。

方式是否保证后置执行备注
yield fixture✅(前置成功时)最推荐,代码简洁
request.addfinalizer✅(前置成功时)与 yield 等价
teardown_* 方法✅(对应作用域)适用于传统风格
try/finally✅(无条件)适合必须清理的场景

5.方法补充

1.使用 setup_function / teardown_function(函数级别)

适用于独立函数的测试用例。

def setup_function(function):
    print("\n[前置] 在每个测试函数前执行")
def teardown_function(function):
    print("[后置] 在每个测试函数后执行")
def test_add():
    assert 1 + 1 == 2
def test_multiply():
    assert 2 * 3 == 6

2.使用 setup_method / teardown_method(类内方法级别)

适用于测试类中的每个测试方法。

class TestMath:

    def setup_method(self):
        print("\n[前置] 每个测试方法前执行")

    def teardown_method(self):
        print("[后置] 每个测试方法后执行")

    def test_add(self):
        assert 1 + 1 == 2

    def test_multiply(self):
        assert 2 * 3 == 6

3. 使用 setup_class / teardown_class(类级别)

整个测试类只执行一次前置和后置。

class TestDatabase:

    @classmethod
    def setup_class(cls):
        print("\n[前置] 整个测试类只执行一次")

    @classmethod
    def teardown_class(cls):
        print("[后置] 整个测试类只执行一次")

    def test_connection(self):
        assert True

    def test_query(self):
        assert True

4. 使用 setup_module / teardown_module(模块级别)

在整个模块(文件)的所有测试前后执行一次。

# test_example.py
def setup_module(module):
    print("\n[前置] 模块级别,执行一次")

def teardown_module(module):
    print("[后置] 模块级别,执行一次")

def test_a():
    assert True

def test_b():
    assert True

5. 使用 @pytest.fixture(最推荐、最强大)

fixture 是 pytest 的核心功能,可以实现任意粒度的前后置,并支持依赖注入、作用域控制、自动清理等。

基本用法(函数级)

import pytest

@pytest.fixture
def db_connection():
    print("\n[前置] 建立数据库连接")
    conn = {"host": "localhost", "port": 3306}
    yield conn   # 将资源传递给测试函数
    print("[后置] 关闭数据库连接")

def test_query(db_connection):
    assert db_connection["port"] == 3306

作用域控制

通过 scope 参数控制生命周期:

scope作用域
function每个测试函数(默认)
class每个测试类
module每个模块文件
package每个包
session整个测试会话
@pytest.fixture(scope="module")
def shared_resource():
    print("\n[前置] 模块级别共享资源")
    yield {"data": "shared"}
    print("[后置] 清理共享资源")

自动使用(autouse=True)

无需在测试参数中显式引用,自动在每个作用域执行。

@pytest.fixture(autouse=True)
def auto_log():
    print("\n[自动前置] 记录测试开始")
    yield
    print("[自动后置] 记录测试结束")

def test_something():
    assert True   # 前后置会自动执行

使用 request 对象获取上下文

@pytest.fixture
def resource(request):
    print(f"测试函数名: {request.node.name}")
    # 可访问 module, cls, function 等
    yield
    print("清理")

6.使用 pytestmark 模块级标记

可以在模块顶部定义 pytestmark 来应用 fixture 到整个模块。

import pytest

pytestmark = pytest.mark.usefixtures("db_connection")

def test_1():
    pass

def test_2():
    pass

7.通过 conftest.py 共享 fixture

将 fixture 定义在 conftest.py 文件中,可被多个测试文件共享。

# conftest.py
import pytest

@pytest.fixture(scope="session")
def global_config():
    return {"env": "test"}
# test_foo.py
def test_config(global_config):
    assert global_config["env"] == "test"

8.前后置执行顺序总结

在一个测试函数中,各钩子的执行顺序:

setup_module
  setup_class
    setup_method
      setup_function (对函数测试有效)
        <测试函数体>
      teardown_function
    teardown_method
  teardown_class
teardown_module

而 fixture 的 yield 前后代码分别对应前置和后置,且支持嵌套依赖。

推荐实践

  • 简单场景setup_method / teardown_method 或 setup_function
  • 复杂/可复用场景始终优先使用 @pytest.fixture,因为它更灵活、支持依赖注入、作用域可控、更符合 pytest 的设计哲学。
  • 全局共享:使用 conftest.py + scope="session"

通过合理使用这些机制,可以编写出清晰、高效、易于维护的测试用例。

到此这篇关于一文带你掌握Python pytest的前后置处理机制与方法的文章就介绍到这了,更多相关pytest前后置处理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • python判断字符串是否纯数字的方法

    python判断字符串是否纯数字的方法

    这篇文章主要介绍了python判断字符串是否纯数字的方法,通过isdigit方法进行判断,并给出了改进的实例及采用正则判断的用法,具有一定的借鉴价值,需要的朋友可以参考下
    2014-11-11
  • 自动化测试时基于Python常用的几个加密算法总结

    自动化测试时基于Python常用的几个加密算法总结

    这几天做自动化测试,遇到一个问题,那就是接口的请求的密码是加密的,产品的要求是不能使用使用其他特殊手段,他给提供加密算法,需要在接口请求的时候,使用加密算法处理后的数据传参,本文主要是整理了几个加密算法,以便后续测试使用,需要的朋友可以参考下
    2023-12-12
  • 解决Python3 struct报错argument for 's' must be a bytes object

    解决Python3 struct报错argument for 's'&

    这篇文章主要为大家介绍了解决Python3 struct报错argument for 's' must be a bytes object方法详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-08-08
  •  Python 匿名函数lambda 详情

     Python 匿名函数lambda 详情

    这篇文章主要介绍了 Python 匿名函数lambda,​​lambda​​​  函数返回函数本身而不是将其赋值给一个变量名。所以它也被称为匿名函数,下文更多相关内容需要的小伙伴可以参考一下
    2022-03-03
  • python3在各种服务器环境中安装配置过程

    python3在各种服务器环境中安装配置过程

    这篇文章主要介绍了python3在各种服务器环境中安装配置过程,源码包编译安装步骤详解,本文通过图文并茂的形式给大家介绍的非常详细,需要的朋友可以参考下
    2022-01-01
  • python利用smtplib实现QQ邮箱发送邮件

    python利用smtplib实现QQ邮箱发送邮件

    这篇文章主要为大家详细介绍了python利用smtplib实现QQ邮箱发送邮件,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-05-05
  • python 以16进制打印输出的方法

    python 以16进制打印输出的方法

    今天小编就为大家分享一篇python 以16进制打印输出的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-07-07
  • 解决python执行较大excel文件openpyxl慢问题

    解决python执行较大excel文件openpyxl慢问题

    这篇文章主要介绍了解决python执行较大excel文件openpyxl慢问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-05-05
  • Python自动化测试Eclipse+Pydev 搭建开发环境

    Python自动化测试Eclipse+Pydev 搭建开发环境

    本文主要介绍python自动化测试环境搭建,这里对Eclipse+Pydev 搭建开发环境做了图文详解,有需要的小伙伴可以参考下
    2016-08-08
  • 使用Python进行验证电子邮件地址

    使用Python进行验证电子邮件地址

    这篇文章主要为大家详细介绍了Python如何使用名为 verify-email 的 Python 库构建你自己的电子邮件验证工具,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-12-12

最新评论