如何正确使用 PHPUnit 9 进行方法级 Mock 避免真实调用-php教程-PHP中文网

如何正确使用 PHPUnit 9 进行方法级 Mock 避免真实调用

本文详解在 phpunit 9 中 mock 类方法时仍触发实际执行的常见原因及解决方案，重点说明 disableoriginalconstructor() 的必要性、mock 对象的正确注入方式，并提供可直接运行的完整示例代码。

本文详解在 phpunit 9 中 mock 类方法时仍触发实际执行的常见原因及解决方案，重点说明 disableoriginalconstructor() 的必要性、mock 对象的正确注入方式，并提供可直接运行的完整示例代码。

在使用 PHPUnit 9 进行单元测试时，一个典型误区是：仅创建 mock 对象并设置期望行为，并不自动阻止原方法执行——前提是该 mock 实例未被真正用于被测逻辑中。你遇到的 Twilio\Exceptions\RestException: [HTTP 403] 错误明确表明：retrieveLastTextFromBot() 方法仍在执行其内部 Twilio SDK 调用，说明测试中实际调用的对象并非你创建的 mock，而是原始类实例（或其依赖未被正确替换）。

✅ 正确做法：确保 mock 实例被真实注入

Mock 的核心原则是 “替换依赖”，而非“拦截任意同名方法”。以下为关键步骤：

禁用原始构造函数（关键！）
若被 mock 类（如 Twilio）有构造依赖（如 Twilio\Rest\Client），必须调用 ->disableOriginalConstructor()，否则 PHPUnit 会尝试实例化真实对象，导致构造阶段就失败或后续方法调用绕过 mock：
```
$twilioStub = $this->getMockBuilder(Twilio::class)
    ->disableOriginalConstructor() // ← 必须添加！
    ->getMock();
```

显式设置期望行为
在 mock 创建后，立即定义方法调用预期与返回值：

$message = (object)['body' => 'This won\'t exist'];
$twilioStub->expects($this->once())
           ->method('retrieveLastTextFromBot')
           ->willReturn($message);

将 mock 注入被测系统（SUT）
确保业务逻辑使用的 Twilio 实例是你创建的 mock，而非 new Twilio(...) 或容器自动解析的真实实例：

// 正确：SUT 显式接收 mock
$sut = new CronController($twilioStub); // 假设构造器接受 Twilio 实例
$sut->remind(); // 此时调用的是 mock 的 retrieveLastTextFromBot()

❌ 错误示例（常见陷阱）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

// 若 CronController 内部自行 new Twilio(...) 或从全局容器取实例，
// 则你的 mock 完全未被使用！
$twilioStub->retrieveLastTextFromBot(); // 单独调用 mock 是 OK 的，
$sut = new CronController();            // 但 SUT 仍用真实 Twilio！

? 排查技巧：确认方法调用来源

若仍不确定哪段代码触发了真实方法，可在生产方法开头加入调试断点：

public function retrieveLastTextFromBot()
{
    // 临时添加，运行测试后立即终止并输出调用栈
    echo "Called from: " . debug_backtrace()[0]['file'] . ":" . debug_backtrace()[0]['line'] . "\n";
    exit(1);

    // ... 原有逻辑
}

若输出显示调用来自 CronController.php（而非测试文件），说明 CronController 并未使用你创建的 $twilioStub，需检查其初始化方式——应通过构造函数/Setter 注入，而非硬编码实例化。