PHPUnit模拟GuzzleHttp\Client失败：无法调用模拟对象求助

你遇到的核心问题是：待测试的AssessmentController::fredsTest()静态方法里直接硬编码实例化了GuzzleHttp\Client（也就是写了new GuzzleHttp\Client()）。

PHPUnit或其他模拟框架的核心逻辑是替换「通过依赖注入传入」或「从容器获取」的对象实例，完全无法拦截代码里直接new出来的类——因为这种写法把依赖和业务逻辑紧绑死了，模拟框架插不上手，自然会走真实的Client请求导致报错。

方案1：重构代码解耦（推荐） #

把硬编码的实例化改成依赖注入，让测试时能传入模拟对象。有两种调整方式：

方式A：将静态方法改为非静态，依赖注入Client #

class AssessmentController
{
    public function fredsTest(GuzzleHttp\Client $client)
    {
        // 使用外部传入的Client，而非自己new
        $response = $client->request('GET', '目标URL');
        // 业务逻辑...
        return 'OK';
    }
}

对应的测试代码：

public function testFredsTest()
{
    // 创建Client模拟对象
    $mockClient = $this->createMock(GuzzleHttp\Client::class);
    // 模拟request方法的返回值
    $mockResponse = $this->createMock(GuzzleHttp\Psr7\Response::class);
    $mockClient->method('request')->willReturn($mockResponse);

    // 调用方法并断言结果
    $controller = new AssessmentController();
    $result = $controller->fredsTest($mockClient);
    $this->assertEquals('OK', $result);
}

方式B：保留静态方法，增加可选依赖参数 #

如果必须保留静态方法，可以给方法加一个可选的Client参数，生产环境不传时自动实例化，测试时传入模拟对象：

class AssessmentController
{
    public static function fredsTest(?GuzzleHttp\Client $client = null)
    {
        // 生产环境自动实例化，测试时用传入的模拟对象
        $client = $client ?? new GuzzleHttp\Client();
        $response = $client->request('GET', '目标URL');
        return 'OK';
    }
}

测试时直接传模拟对象即可，无需改太多测试代码。

方案2：静态类重载（仅用于无法重构的场景） #

如果完全没办法修改原代码，可以用Mockery的静态重载功能强制替换Client类，但这种方式侵入性强，容易影响其他测试，不推荐：

use Mockery;

public function testFredsTest()
{
    // 全局重载GuzzleHttp\Client类
    $mockClient = Mockery::mock('overload:GuzzleHttp\Client');
    $mockClient->shouldReceive('request')
               ->andReturn(Mockery::mock(GuzzleHttp\Psr7\Response::class));

    $result = AssessmentController::fredsTest();
    $this->assertEquals('OK', $result);
    
    // 测试后清理Mockery
    Mockery::close();
}

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