如何在Python 3.12中使用pytest编写高效的单元测试？-Python教程-PHP中文网

Python 3.12 下 pytest 无语法新特性，但需升级至 pytest 7.4.0+（推荐 8.2+）并适配 async fixture、__getattr__ 行为及 pytest-asyncio 0.23.0+，否则出现静默跳过或 ImportError。

如何在python 3.12中使用pytest编写高效的单元测试？

Python 3.12 中 pytest 本身没有语法级新特性，但运行时行为和兼容性有细微变化——关键不是“怎么写新东西”，而是“别踩 3.12 引入的隐性坑”。比如 async fixture 支持更严格、__getattr__ 在测试类中触发方式变了，老写法可能静默失效。

pytest 7.4+ 在 Python 3.12 下必须升级到的最低版本

低于 pytest 7.4.0 的版本在 Python 3.12 上会报 ImportError: cannot import name 'Mapping' from 'collections'——因为 Python 3.12 移除了 collections.Mapping（改用 collections.abc.Mapping）。这不是你代码的问题，是 pytest 自身依赖没适配。

执行 pip install "pytest>=7.4.0"，推荐直接上 pytest 8.2+
检查版本：python -m pytest --version，确认输出含 pytest 8.x 或 7.4.x
如果用了 pytest-asyncio，也得同步升到 0.23.0+，否则 @pytest.mark.asyncio 会跳过或卡住

async def 测试函数必须显式标记 `@pytest.mark.asyncio`

Python 3.12 对协程对象的类型检查更严，pytest 不再自动识别 async def test_xxx() 为可运行测试。不加标记会导致测试被跳过，且无提示。

Secure Python Code Sandbox

安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

错误写法：async def test_fetch_data(): ... → 运行时完全不执行

正确写法：

@pytest.mark.asyncio
async def test_fetch_data():
    assert await some_async_func() == "ok"

如果整个文件都是 async 测试，可在 pytest.ini 加：asyncio_mode = auto，但 Python 3.12 + pytest 8.2 起该配置已被弃用，不推荐依赖

避免在测试类里重写 `getattr` 或 `getattribute`

Python 3.12 修改了描述符协议调用顺序，导致测试类中自定义的 __getattr__ 可能拦截 pytest 的内部属性访问（如 self.request、self.tmp_path），引发 AttributeError 或奇怪的 None 返回。

现象：使用 tmp_path fixture 时突然报 AttributeError: 'TestFoo' object has no attribute 'tmp_path'

临时解法：把 __getattr__ 改成只处理明确前缀，例如：

def __getattr__(self, name):
    if name.startswith("mock_"):
        return Mock()
    raise AttributeError(f"{type(self).__name__} has no attribute '{name}'")