PHPUnit测试框架中部分模拟类构造方法调用的陷阱与解决方案

问题背景

在PHPUnit 11.2.0版本中，一个长期存在的测试模式突然失效了——当开发者尝试对类方法进行部分模拟(mock)时，如果被模拟的方法在类的构造函数中被调用，测试会抛出"Typed property must not be accessed before initialization"的错误。这个问题最初是在TYPO3项目的夜间构建管道中被发现的。

技术细节分析

这个问题的根源在于PHPUnit 11.2.0为了支持readonly可扩展类而进行的内部重构。在之前的版本中，PHPUnit的测试替身(test double)功能可以很好地处理以下场景：

1. 创建一个类的部分模拟(partial mock)
2. 只替换(override)类的特定方法
3. 即使被替换的方法在构造函数中被调用，也能正常工作
4. 后续对模拟方法的调用计数验证也能正确执行

但在11.2.0版本中，由于内部状态管理的改变，当构造函数尝试调用被模拟的方法时，PHPUnit的模拟对象内部状态尚未完全初始化，导致类型属性访问错误。

问题复现

考虑以下简单类定义：

class ClassCallingMethodInConstructor {
    public function __construct() {
        $this->reset();
    }
    
    public function reset(): void {}
    
    public function second(): void {
        $this->reset();
    }
}

以及对应的测试用例：

public function testOnlyMethodCalledInConstructorWorks() {
    $testClassMock = $this->getMockBuilder(ClassCallingMethodInConstructor::class)
        ->onlyMethods(['reset'])
        ->getMock();

    $testClassMock->expects($this::once())->method('reset');
    $testClassMock->second();
}

在PHPUnit 11.2.0之前，这个测试能够正常通过，验证second()方法确实调用了一次reset()方法。但在新版本中，由于构造函数中的reset()调用触发了模拟对象内部状态访问，导致测试失败。

解决方案的探索

PHPUnit维护者Sebastian Bergmann确认了这个问题，并进行了深入分析：

1. 问题的复杂性源于PHPUnit测试替身功能不仅支持接口，还支持可扩展类
2. 允许只替换类的部分方法这一特性增加了实现的复杂度
3. 为支持readonly类所做的改动意外影响了原有功能

经过多次尝试，维护者已经找到了解决方案的方向，并在本地环境中成功让示例测试通过。不过，这一改动还导致其他一些测试失败，需要进一步调整以确保整体兼容性。

对开发者的建议

对于遇到类似问题的开发者，可以考虑以下临时解决方案：

1. 重构测试代码，避免在构造函数中调用被模拟的方法
2. 使用不同的测试策略，如创建完整的测试替身而非部分模拟
3. 暂时回退到PHPUnit 11.1.x版本

长期来看，等待PHPUnit官方发布修复版本是最稳妥的方案。这个问题也提醒我们：

• 在复杂系统中，看似无关的功能改动可能产生意想不到的副作用
• 完善的测试覆盖对于发现这类问题至关重要
• 项目夜间构建管道是早期发现问题的重要工具

总结

PHPUnit 11.2.0引入的这个问题展示了测试框架开发中的典型挑战——在添加新功能时保持现有行为的稳定性。虽然部分模拟类在构造函数中调用方法是一个相对边缘的用例，但它确实存在于许多实际项目中。这个案例也体现了开源社区协作的价值，通过用户反馈和核心维护者的快速响应，问题得以迅速识别并正在解决中。