pytest升级后跳过测试时__new__调用行为的变化分析

背景介绍

在pytest测试框架中，开发者经常使用跳过标记(skip marker)来控制特定测试用例的执行。近期有用户从pytest 6.2.5升级到8.3.3版本后发现，测试类的__new__方法调用行为发生了变化，这影响了他们原有的测试安全机制实现方式。

问题现象

在pytest 6.2.5版本中，当通过pytest_collection_modifyitems钩子为测试项添加跳过标记时：

• 如果测试被标记为跳过，测试类的__new__方法不会被调用
• 只有未被跳过的测试才会触发__new__方法的执行

而在升级到pytest 8.3.3后：

• 无论测试是否被跳过，测试类的__new__方法都会被调用
• 这导致原本依赖__new__方法进行环境安全检查的代码出现了问题

技术分析

原有实现机制

用户原有的实现方式是在unittest.TestCase的子类中重写__new__方法，用于执行环境安全检查。当检测到不安全的测试环境时，会抛出异常阻止测试执行。这种实现方式依赖于pytest 6.2.5版本中跳过测试时不实例化测试类的行为特性。

pytest内部机制变化

pytest核心开发者指出，测试类实例化是unittest.TestCase的标准契约行为。在早期版本中跳过测试时不调用__new__实际上是一个实现细节而非设计特性。随着pytest内部实现的改进，8.3.3版本更加严格地遵循了unittest的契约，确保测试类总是会被实例化。

安全机制的正确实现方式

对于需要在测试执行前进行环境检查的场景，推荐使用以下替代方案：

1. setUpClass类方法：在类级别进行一次性检查

@classmethod
def setUpClass(cls):
    if not is_safe_environment():
        raise unittest.SkipTest("Unsafe environment")
    super().setUpClass()

2. setUp实例方法：在每个测试方法执行前进行检查

def setUp(self):
    if not is_safe_environment():
        raise unittest.SkipTest("Unsafe environment")
    super().setUp()

3. 自定义pytest标记：结合pytest的标记系统和钩子函数实现更灵活的检查

@pytest.mark.safe_environment
def test_something(self):
    pass

最佳实践建议

1. 避免依赖框架内部实现细节：__new__方法的调用行为属于框架实现细节，不应作为安全检查的依赖点

2. 明确区分收集阶段和执行阶段：pytest的测试生命周期中，收集阶段和执行阶段有不同的职责，安全检查应放在合适的阶段

3. 考虑多种运行场景：如果测试可能通过不同方式运行(如直接使用unittest运行器)，应确保安全机制在所有场景下都有效

4. 使用标准扩展点：优先使用unittest或pytest提供的标准扩展点(如setUp、标记系统)来实现自定义逻辑

结论

pytest从6.2.5到8.3.3版本的这一行为变化，实际上是框架朝着更加规范和可靠的方向发展。开发者应该调整测试安全机制的实现方式，使用更加标准和可靠的方法来进行环境检查。这不仅解决了当前的问题，也使代码更加健壮和可维护。