如何模拟Laravel的request()辅助函数并解决模拟未调用报错

报错根因 #

之前的实现之所以抛出“模拟方法从未被调用”的报错，核心存在两个问题：

• 容器绑定键不匹配：request()辅助函数的底层逻辑是执行app('request')，从容器中解析键为request的实例，而非解析绑定键为Illuminate\Http\Request::class的抽象。之前直接Mock Request::class，并没有把Mock实例挂载到request()实际读取的容器键上，业务代码运行时根本不会触达你创建的Mock对象。
• 方法匹配规则缺失：业务代码中input方法是带参数调用的（传入了'name'），默认Mock会做严格入参校验，哪怕绑定了正确的容器键，没有指定入参匹配规则也可能触发调用不匹配的报错。

两种正确实现方案 #

方案1：优先使用Laravel内置请求伪造能力（推荐） #

如果不需要对input方法的调用次数、调用行为做强制断言，完全不需要手动写Mock，直接替换容器中的请求实例即可，稳定性远高于手动Mock：

// 构造带有预设参数的真实请求实例
$testRequest = \Illuminate\Http\Request::create(
    uri: '/test-route',
    method: 'GET',
    parameters: ['name' => '你的预设测试值']
);
// 将实例绑定到request()实际读取的容器键上，覆盖默认绑定
$this->app->instance('request', $testRequest);

对于HTTP功能测试场景，更不需要额外处理：直接在模拟请求路由时传入对应参数，框架会自动将参数绑定到请求实例，业务代码中调用request()->input('name')会直接读取到传入的测试值。

// 功能测试示例
$this->post('/your-business-route', ['name' => '测试值'])
    ->assertOk();

方案2：手动编写适配容器的Mock（适合需要行为断言的场景） #

如果必须要校验input方法的调用次数、入参，只需要在原有代码基础上调整细节即可解决问题，两种等价写法都可使用：

• 写法A：直接在Mock时指定正确的容器键

$this->mock('request', function ($mock) {
    $mock->shouldReceive('input')
        ->once() // 限定方法仅被调用1次
        ->with('name') // 限定仅匹配入参为'name'的调用
        ->andReturn('你的预设测试值');
});

• 写法B：保留原有Request::class的Mock逻辑，补充容器绑定步骤

$requestMock = $this->mock(Request::class);
$requestMock->shouldReceive('input')
    ->once()
    ->with('name')
    ->andReturn($name);
// 关键补充：将Mock实例绑定到request()实际解析的容器键
$this->app->instance('request', $requestMock);

避坑提示 #

• 不要混淆容器绑定入口：哪怕默认情况下Request::class的解析结果和request键指向同一个实例，Mock时绑定错误的容器键会导致整个Mock完全不生效。
• 非必要场景不强制使用Mock：如果仅需要模拟请求参数、不需要校验方法调用行为，直接使用真实的Request实例伪造参数会大幅降低测试的脆弱性，减少后续框架版本升级带来的测试失效问题。

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