Pytest+Django中不同作用域fixture如何共享DB实现事务隔离

ScopeMismatch报错的直接原因是pytest-django默认提供的dbfixture为函数级作用域，pytest本身不允许高作用域（类/模块/包/会话）fixture依赖低作用域fixture，因此类级及以上的fixture直接注入db必然触发错误。
你之前尝试的django_db_blocker.unblock()方案确实可以绕过作用域限制访问数据库，但这个API仅负责解除测试期间的数据库访问拦截，没有绑定对应作用域的生命周期清理逻辑，才会出现测试结束后数据残留、手动清理容错率低的问题，不属于用法错误。

核心思路是基于数据库保存点（Savepoint）机制，为每个fixture作用域实现独立的事务边界：作用域启动时创建保存点，作用域内所有fixture和测试用例共享该事务上下文，作用域结束时回滚到对应保存点，自动清理该作用域下创建的所有测试数据，无需手动编写删除逻辑。
该方案完全覆盖会话/包/模块/类/函数五层fixture作用域，数据自动隔离清理，不会出现串扰。

第一步：在conftest.py中定义分层数据库fixture #

先编写各作用域对应的数据库访问fixture，替代默认仅支持函数级的dbfixture：

import pytest
from django.db import connection


@pytest.fixture(scope="session")
def django_db_setup(django_db_setup, django_db_blocker):
    """会话级数据库初始化钩子，整个测试执行周期仅运行一次"""
    with django_db_blocker.unblock():
        # 可在此处写入全测试会话共享的基础数据（如枚举值、全局权限等）
        # 这部分数据会在测试结束后随测试数据库一同删除
        pass


@pytest.fixture(scope="package")
def package_db(django_db_blocker):
    """包作用域数据库fixture，包内所有测试共享数据，包执行结束自动清理"""
    with django_db_blocker.unblock():
        savepoint = connection.savepoint()
        yield
        connection.savepoint_rollback(savepoint)


@pytest.fixture(scope="module")
def module_db(package_db, django_db_blocker):
    """模块作用域数据库fixture，模块内所有测试共享数据，模块执行结束自动清理"""
    with django_db_blocker.unblock():
        savepoint = connection.savepoint()
        yield
        connection.savepoint_rollback(savepoint)


@pytest.fixture(scope="class")
def class_db(module_db, django_db_blocker):
    """类作用域数据库fixture，类内所有测试共享数据，类执行结束自动清理"""
    with django_db_blocker.unblock():
        savepoint = connection.savepoint()
        yield
        connection.savepoint_rollback(savepoint)


@pytest.fixture(scope="function")
def function_db(class_db, django_db_blocker):
    """函数作用域数据库fixture，单测试内生效，测试结束自动清理临时数据"""
    with django_db_blocker.unblock():
        savepoint = connection.savepoint()
        yield
        connection.savepoint_rollback(savepoint)


@pytest.fixture(scope="function")
def db(function_db):
    """兼容原有代码中注入`db`的写法，无需修改存量fixture逻辑"""
    yield

第二步：调整原有fixture的依赖 #

类级及以上作用域的fixture不再注入默认的db，而是注入对应作用域的数据库fixture即可，修改后的示例代码：

@pytest.fixture(scope="function")
def my_method_user(db):
    user = User(name="method_user")
    user.save()
    return user


@pytest.fixture(scope="class")
def my_class_user(class_db):
    user = User(name="class_user")
    user.save()
    return user


@pytest.mark.usefixtures("my_class_user")
class TestClass:
    def test_user_count(self, db):
        # 注入db开启函数级事务上下文，可正常读取类级创建的用户数据
        assert User.objects.count() == 1

    def test_user_count_2(self, db, my_method_user):
        # 同时读取到类级用户+当前函数fixture创建的用户
        assert User.objects.count() == 2

• 不要在高作用域fixture中主动调用transaction.commit()，否则会突破保存点的事务边界，导致回滚失效。如果确实需要提交事务的初始化数据，统一放到django_db_setup会话级钩子中处理，这部分数据会随测试库销毁自动清理。
• 该方案与pytest-django默认的测试数据库复用逻辑（--reuse-db参数）完全兼容，不会影响测试执行速度。
• 不同作用域的数据遵循pytest原生的fixture可见性规则：测试用例可以访问所有上层作用域fixture创建的数据，同级别不同上下文（如两个测试类、两个测试函数）的数据完全隔离，不会互相污染。

你的使用思路不存在根本性偏差，pytest-django默认的dbfixture仅覆盖了最常用的函数级隔离场景，没有内置分层作用域的事务支持，上述实现是目前Django测试生态中通用的成熟方案，无需引入额外第三方依赖。

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