PHP ReflectionClass::newInstanceWithoutConstructor 如何测试遗留对象：构造跳过与属性初始化边界

给一个带外部依赖的老 PHP 类补单元测试时，最麻烦的往往不是断言，而是它的构造函数会立刻连数据库、读配置或注册客户端。ReflectionClass::newInstanceWithoutConstructor() 可以创建一个不执行构造函数的对象，让测试先把关注的属性补齐；但它不会替你初始化 typed property，直接读取空属性会触发运行时错误。

把反射对象当作“未完成的测试夹具”：先创建，再用 ReflectionProperty::isInitialized() 检查状态，最后只注入本次测试需要的字段。

先把遗留类的测试边界缩小

假设有一个订单计价器，旧构造函数必须接收数据库连接和配置。我们只想验证 total() 对折扣字段的计算，不想让测试先启动真实连接。示例中的字段名、方法名和异常状态都是真实代码的一部分，后面的两张图也只解释这条夹具链路。

db = $db;
        $this->discount = 0;
    }

    public function total(int $amount): int {
        return $amount - $this->discount;
    }
}

这里的测试目标是 total()，不是验证 PDO 初始化。因此可以把“对象创建”和“依赖注入”拆开。

用 ReflectionClass 跳过构造函数

先取得 ReflectionClass，再调用 newInstanceWithoutConstructor()。这一调用只返回对象，不会运行 LegacyPrice::__construct()，所以 db 和 discount 都还没有自动完成初始化。

$reflection = new ReflectionClass(LegacyPrice::class);
$price = $reflection->newInstanceWithoutConstructor();

如果把这个对象立即交给会读取 discount 的方法，结果可能是 Runtime Error，而不是一个默认的零。这个差异正是测试夹具需要明确处理的地方。

注入字段前先确认属性状态

测试只需要给 discount 赋值。通过 ReflectionProperty 可以访问私有属性，先用 isInitialized() 观察状态，再调用 setValue() 注入数据：

$discount = new ReflectionProperty(LegacyPrice::class, 'discount');
if (!$discount->isInitialized($price)) {
    $discount->setValue($price, 30);
}

assert($price->total(100) === 70);

这个判断避免测试代码误以为所有属性都有默认值。若被测方法还会读取 db，就必须为它注入可用的替身，或者把测试边界改到不触发数据库访问的方法。

一个可运行的最小测试夹具

$reflection = new ReflectionClass(LegacyPrice::class);
$price = $reflection->newInstanceWithoutConstructor();
$discount = new ReflectionProperty(LegacyPrice::class, 'discount');
$discount->setValue($price, 30);

if ($price->total(100) !== 70) {
    throw new RuntimeException('total mismatch');
}
echo "ok\n";

运行脚本后应看到 ok。如果报“must not be accessed before initialization”，先检查被测方法是否间接读取了 db 或其他未注入字段，不要用一个随意的默认值掩盖依赖缺失。

什么时候该停用这种反射夹具

它的价值在于隔离遗留构造函数，帮助你先补上行为测试。新代码仍应优先通过公开构造函数表达依赖；如果测试长期依赖多个私有字段，说明类的职责或依赖边界已经值得重构。对于内部类、不可绕过构造函数的对象，反射还可能抛出 ReflectionException，应回到工厂方法或专用测试替身。

常见问题

跳过构造函数会自动填充 typed property 吗？

不会。没有默认值的属性保持未初始化，读取前应使用 isInitialized() 判断。

可以用 setValue 修改私有属性吗？

可以用于测试夹具注入，但字段必须属于当前对象的类层次，且注入值仍要符合属性类型。

生产代码适合经常调用 newInstanceWithoutConstructor() 吗？

通常不适合。它绕开了构造函数的不变量，适合隔离遗留代码的测试，不应成为正常对象创建路径。

验收清单

• 确认测试只绕开了外部依赖，没有绕开被测行为本身。
• 每个被读取的 typed property 都已注入或有默认值。
• 异常路径能区分“属性未初始化”和“业务计算失败”。
• 测试通过后，记录是否可以逐步恢复公开构造函数。