Laravel 9.x中Partial Mocks无法生效问题求助

针对你遇到的部分模拟（Partial Mock）不生效、内部方法依然执行真实逻辑的问题，结合你的技术栈（Laravel 9.x、PHP 8.1、PHPUnit 9.5、Mockery 1.5），可以从以下几个方向排查：

1. 被模拟的方法是否为私有/受保护 #

Mockery 只能直接模拟公共方法，如果internalMethod是私有或受保护的，部分模拟不会生效——这类方法无法被Mockery拦截。

• 解决思路：要么通过反射临时修改方法可见性（不推荐，破坏代码封装），要么重构代码，把该方法抽成独立的服务类，再对这个服务进行模拟。

2. 部分模拟的创建方式有误 #

你尝试的第一种方式Mockery::mock($myClassInstance)->makePartial()存在问题：基于已实例化的对象创建部分模拟，可能无法正确拦截内部方法调用。正确的做法是直接基于类创建部分模拟：

// 正确示例
$mockMyClass = $this->partialMock(MyClass::class, function (MockInterface $mock) use ($responseInternalMethod) {
    $mock->shouldReceive('internalMethod')
         ->andReturn($responseInternalMethod);
});

避免传入已实例化的对象，因为现有实例的方法绑定逻辑可能已经固化，Mockery无法覆盖。

3. 方法调用的上下文不匹配 #

如果被测试的方法是通过容器解析实例调用的，要确保容器返回的是你创建的模拟对象，而不是重新实例化真实类：

// 绑定模拟对象到容器
$this->app->instance(MyClass::class, $mockMyClass);

// 从容器获取实例并调用方法
$service = $this->app->make(MyClass::class);
$service->yourTestMethod();

如果直接调用模拟对象的方法没问题，但通过容器/依赖注入获取的实例还是真实类，那就是容器绑定的问题。

4. Mockery 期望的参数匹配不正确 #

如果internalMethod有参数，你需要确保shouldReceive的参数匹配逻辑正确，否则Mockery会认为这是另一个调用，依然执行真实方法：

// 匹配任意参数
$mock->shouldReceive('internalMethod')
     ->withAnyArgs()
     ->andReturn($responseInternalMethod);

// 匹配特定参数
$mock->shouldReceive('internalMethod')
     ->with($expectedParam)
     ->andReturn($responseInternalMethod);

5. 测试环境配置问题 #

确保你的测试类继承了Illuminate\Foundation\Testing\TestCase，Laravel的TestCase会自动处理Mockery的初始化和清理。如果是自定义测试类，要在tearDown方法中调用Mockery::close()，避免Mockery状态污染。

内容的提问来源于stack exchange，提问作者Roberto Funes