Laravel中PHPUnit部分Mock带构造参数的Service遇依赖未初始化问题

在Laravel里用PHPUnit做接口测试时，如果你需要Mock服务类的某个方法（比如避免发邮件）但又不想破坏原类的依赖注入，别直接用Mockery::partialMock()跳过构造函数，试试下面几种靠谱的方案：

方案1：先通过容器实例化真实服务，再做部分Mock #

先让Laravel容器帮你初始化完整的ReservationService（包括自动注入所有依赖），再对这个实例做部分Mock，只替换你需要的方法，最后把Mock实例放回容器供接口调用时使用。

示例代码：

public function testCancelSeatsApi()
{
    // 从容器获取已完成依赖注入的真实服务实例
    $realService = app(ReservationService::class);
    
    // 对真实实例做部分Mock，仅替换sendReservationMail方法
    $mockedService = Mockery::mock($realService)->makePartial();
    $mockedService->shouldReceive('sendReservationMail')
        ->once() // 可选：断言方法被调用次数
        ->andReturn(true); // 模拟方法返回值
    
    // 将Mock实例绑定回容器，覆盖原服务
    $this->app->instance(ReservationService::class, $mockedService);
    
    // 发起接口请求
    $response = $this->postJson('/api/cancel-seats', [
        // 填入你的测试参数，比如reservation_id等
    ]);
    
    // 断言接口响应符合预期
    $response->assertStatus(200);
}

这种方式的核心是先让容器完成依赖注入，再Mock指定方法，既保留了原类的所有依赖，又避免了实际发送邮件。

方案2：使用Mockery Spy保留原服务功能 #

Spy是Mockery的一种特殊类型，它会保留原对象的所有功能，同时允许你监听或替换特定方法，完全不会跳过构造函数，依赖注入自然正常工作。

示例代码：

public function testCancelSeatsApi()
{
    // 创建ReservationService的Spy实例
    $serviceSpy = Mockery::spy(ReservationService::class);
    
    // 让Spy的sendReservationMail方法不执行实际发邮件逻辑
    $serviceSpy->shouldReceive('sendReservationMail')
        ->andReturnNull();
    
    // 绑定Spy到容器
    $this->app->instance(ReservationService::class, $serviceSpy);
    
    // 发起接口请求
    $response = $this->postJson('/api/cancel-seats', [/* 测试参数 */]);
    
    // 可选：断言sendReservationMail确实被调用过
    $serviceSpy->shouldHaveReceived('sendReservationMail');
    
    $response->assertStatus(200);
}

Spy特别适合这种需要保留原服务大部分逻辑，仅拦截少数方法的场景，代码更简洁，也不容易出错。

方案3：手动注入依赖到PartialMock（不推荐） #

如果一定要用partialMock，可以手动把容器里的依赖传给Mock的构造函数，不过这种方式需要你明确知道服务类的所有构造参数，扩展性差，不推荐长期使用。

示例代码：

public function testCancelSeatsApi()
{
    // 从容器获取需要注入的依赖
    $virtualAgentService = app(VirtualAgentService::class);
    // 如果还有其他依赖，也要一并获取
    
    // 创建PartialMock并手动传入依赖
    $mockedService = Mockery::mock(ReservationService::class, [
        $virtualAgentService
        // 其他构造参数
    ])->makePartial();
    
    $mockedService->shouldReceive('sendReservationMail')->andReturn(true);
    
    $this->app->instance(ReservationService::class, $mockedService);
    
    // 发起请求并断言
    $response = $this->postJson('/api/cancel-seats', [/* 参数 */]);
    $response->assertStatus(200);
}

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