mock在laravel中仅限tests目录的phpunit测试使用,是隔离外部依赖的测试替身而非性能优化手段;应优先用http::fake()等内置fake方法,仅当需验证特定参数调用且无对应fake时才用mockery。

Mock 在 Laravel 测试中不是万能胶,用错地方反而掩盖真实问题。**绝大多数场景下,优先用 Http::fake()、Queue::fake()、Bus::fake() 或 Notification::fake(),而不是手动 mock 门面或服务类**——它们更安全、语义清晰、且自动清理。
什么时候该用 Mockery 而不是 fake?
只有当你需要验证「被测对象是否以特定参数调用了某个外部依赖的方法」,且该依赖无法被框架内置 fake 覆盖时,才考虑 Mockery。
- 第三方 SDK 封装类(如
TwilioClient、StripeService),没走 Laravel 的Http或Notification门面 - 自定义的非 Laravel 标准接口实现(比如你写了
PaymentGateway抽象,有多个具体实现) - 需要断言方法调用次数、顺序,或捕获传入的闭包参数
-
Mail::fake()不够用——比如你要确认邮件里是否调用了$message->embedData(...)这种底层方法
其他情况硬上 Mockery::mock(),大概率是设计耦合过重,或者没看清框架已提供的能力。
Mockery 基本写法和易错点
别直接 Mockery::mock(MyService::class) 然后塞进容器——Laravel 的服务容器会缓存单例,导致后续测试污染。正确做法是:在测试前用 $this->app->instance() 替换实例,并在 tearDown() 中清除。
- 先创建 mock:
$mock = Mockery::mock(MyService::class)->makePartial();(makePartial()保留未 stub 的方法,避免全盘 mock 引发意外) - 注入容器:
$this->app->instance(MyService::class, $mock); - 设置期望:
$mock->shouldReceive('send')->with('order_123')->once()->andReturn(true); - 运行被测代码(如控制器方法或 job handle)
- 最后必须加
$this->afterApplicationDestroyed(function () { Mockery::close(); });,否则 mock 会泄漏到下一个测试
漏掉 Mockery::close() 是最常导致“某次测试莫名失败但单独跑又通过”的元凶。
比 Mockery 更轻量的替代方案
很多你以为必须 mock 的场景,其实有更稳的方式:
- 要测「发邮件是否带附件」?用
Mail::fake();后调用Mail::assertSent(OrderShipped::class, function ($mail) { return $mail->hasAttachment('invoice.pdf'); }); - 要测「队列任务是否带特定 tag」?用
Queue::fake();后分发任务时加->onQueue('urgent')->delay(now()->addMinutes(5)),再用Queue::assertPushedOn('urgent', ...) - 要测「通知是否发给了正确频道」?用
Notification::fake();后Notification::assertSentTo($user, InvoicePaid::class, function ($notification, $channels) { return in_array('database', $channels); });
这些 fake 方法不接管内部逻辑,只拦截发送行为并记录元数据,既可断言,又不会破坏原有流程。
Mock 门面为什么危险?
直接 Mockery::mock('alias:App\Facades\CustomApi') 或 \Mockery::spy(\App\Facades\CustomApi::class) 极易出问题:
- 门面是静态代理,mock 后无法保证单例生命周期,不同测试间状态残留
- 一旦门面背后实际调用了另一个依赖(比如它内部又用了
Http),mock 就变成黑盒,断言失焦 - Laravel 9+ 已明确建议避免自定义门面,改用依赖注入 + 接口契约
真要隔离门面行为,不如把它背后的真实客户端抽成接口,然后在测试中 bind 一个 mock 实现——这样控制权在你手上,而非靠静态魔术。
复杂点在于:mock 的边界很难界定。你 mock 得越深,测试离真实行为就越远;mock 得越浅,又容易被外部副作用干扰。与其花时间调试 mock 行为,不如先检查这个依赖能不能被 fake 覆盖,或者它的职责是否该拆得更细。











