
在 laravel 单元测试中,对 eloquent 模型进行局部 mock(如仅 mock `save()` 方法)时,必须使用 `makepartial()` 并直接操作 mock 实例,而非新建原始模型对象,否则真实方法仍会被调用。
在 Laravel 测试中,Mockery::mock("App\Order[save]") 语法看似指定了要 Mock 的方法,但仅声明不生效——它不会自动拦截对新实例(如 new Order())的调用。关键问题在于:你通过 $this->app->instance("App\Order", $mock) 将 Mock 实例绑定到了服务容器,但随后却创建了全新的 Order 实例($order = new Order()),该实例完全绕过容器,自然调用的是真实类逻辑。
✅ 正确做法是:
- 使用 makePartial() 创建可部分模拟的 Mock 实例(允许未定义方法调用真实实现,仅覆盖指定方法);
- 直接调用 Mock 实例的方法,而非新建模型对象;
- 确保 Mock 绑定到容器(如需被依赖注入场景复用)。
以下是修正后的完整示例:
makePartial();
// 定义期望行为:save() 被调用一次,返回 5
$mock->shouldReceive('save')->once()->andReturn(5);
// 将 Mock 实例绑定至容器(若后续测试中需通过 app() 或依赖注入获取)
$this->app->instance(Order::class, $mock);
// ✅ 关键:直接调用 $mock,而非 new Order()
$result = $mock->save();
$this->assertEquals(5, $result);
}
}⚠️ 注意事项:
- 不要混用 new Order() 和容器绑定:new 总是创建真实实例,与容器无关;
- makePartial() 是必须的——它使 Mock 支持“部分模拟”,即未 stub 的方法仍可调用原逻辑(例如 fill()、属性访问等),而纯 mock() 会拦截所有方法(除非显式 passthru());
- 若需测试模型与其他组件(如 Repository、Service)的协作,建议将模型依赖通过构造函数或 setter 注入,并 Mock 接口或具体类,而非直接 Mock Eloquent 模型本身(更符合测试隔离原则);
- 在 tearDown() 中调用 Mockery::close() 可避免 Mockery 全局状态污染,提升测试稳定性。
总结:局部 Mock 的核心在于「操作 Mock 实例本身」,而非期望容器自动替换所有新建对象。理解 Laravel 对象生命周期(new vs app())是解决此类问题的关键。










