pytest 8.2.0版本中unittest收集阶段调用@property的问题分析

在pytest 8.2.0版本中，对unittest测试用例的收集机制进行了重要变更，这导致了一个潜在的性能问题：在测试收集阶段会调用测试类中定义的@property属性。这一行为可能会显著增加测试套件的整体运行时间，特别是当@property中包含耗时操作时。

问题现象

当使用pytest 8.2.0及以上版本运行包含@property的unittest测试类时，这些属性会在测试收集阶段被调用。例如，考虑以下测试代码：

import unittest
from time import sleep

class TestClass(unittest.TestCase):
    @property
    def variable(self):
        print('收集阶段调用')
        sleep(10)  # 模拟耗时操作

class MyTest(TestClass):
    def test_simple(self):
        assert True

在pytest 8.2.0之前，这个测试套件的收集阶段几乎是瞬时的。但在8.2.0及以后版本中，收集阶段会执行@property装饰的方法，导致整个收集过程需要额外等待10秒。

技术背景

这个行为变化的根本原因在于pytest 8.2.0中对unittest测试收集机制的修改。在8.2.0版本之前，pytest在收集unittest测试时是在类级别进行的，而之后改为在实例级别进行收集。

具体来说：

1. 旧版行为：pytest直接在类对象上操作，访问属性时不会触发property的执行
2. 新版行为：pytest先创建测试实例，然后在实例上查找属性，这会触发property的执行

这种变化是为了使unittest测试的收集行为与普通pytest测试保持一致，但同时也带来了这个副作用。

影响范围

这个问题主要影响以下场景：

1. 使用unittest.TestCase作为基类的测试
2. 测试类中定义了@property属性
3. 这些属性中包含耗时操作或副作用

在实际项目中，常见的受影响情况包括：

• 数据库连接属性
• 网络请求属性
• 复杂计算属性
• 带有副作用的属性（如文件操作）

解决方案

目前官方推荐的解决方案是：

1. 降级到pytest 8.1.2：如果项目严重依赖这种行为，可以暂时使用8.1.2版本
2. 重构测试代码：将耗时操作从property中移出，改为普通方法或fixture

对于需要立即解决的场景，可以考虑以下临时方案：

import os
import pytest

def safe_property(func):
    @property
    def wrapper(*args, **kwargs):
        if os.environ.get('PYTEST_CURRENT_TEST'):
            return func(*args, **kwargs)
    return wrapper

class TestClass(unittest.TestCase):
    @safe_property
    def variable(self):
        print('只在测试执行时调用')
        sleep(10)
        return 1

这个装饰器利用了pytest设置的环境变量，确保property只在测试执行阶段被调用，而不是在收集阶段。

未来展望

pytest开发团队已经意识到这个问题，并正在考虑以下改进方向：

1. 添加配置选项来控制此行为
2. 优化属性访问逻辑，避免在收集阶段调用property
3. 可能恢复类级别的收集方式，但需要解决相关技术挑战

对于性能敏感的项目，建议密切关注pytest的后续版本更新，特别是关于这个问题的修复进展。同时，在测试代码中谨慎使用@property，特别是那些包含耗时操作的属性，是当前的最佳实践。