如何解决Laravel中PHPUnit无法覆盖$request查询参数的问题

我在Laravel控制器里用$request->merge修改subject_type查询参数的值，浏览器或API测试工具请求时正常生效，但PHPUnit测试里没法覆盖这个参数。

控制器代码：

class UserController extends Controller
{
    public function index(Request $request)
    {
        $request->merge(['filter' => ['subject_type' => 'new_value']]);

        return QueryBuilder::for(User::class)
            ->allowedFilters([AllowedFilter::exact('subject_type')])
            ->allowedSorts(['created_at'])
            ->defaultSort('-created_at')
            ->paginate($request->query('per_page', config('pagination.default.per_page_limit')));
    }
}

测试用例代码：

public function test_can_see_activity_log()
{
      $response = $this->getJson('/api/v1/users?filter[subject_type]=App\Models\Post');
}

相关版本：

• phpunit/phpunit: ^9.5.10
• laravel/framework: ^9.19
• spatie/laravel-query-builder: ^5.3

原因分析 #

问题出在Spatie QueryBuilder的参数读取逻辑：它在调用QueryBuilder::for()时就会立即解析请求中的filter参数，即便你之后用$request->merge修改了请求内容，已经初始化的QueryBuilder也不会再读取更新后的参数。

方案一：直接给QueryBuilder设置Filter（推荐） #

绕过请求参数的修改，直接在QueryBuilder中强制指定subject_type的值，这是最可靠的方式：

public function index(Request $request)
{
    return QueryBuilder::for(User::class)
        ->allowedFilters([AllowedFilter::exact('subject_type')])
        ->setFilters(['subject_type' => 'new_value']) // 强制覆盖filter值
        ->allowedSorts(['created_at'])
        ->defaultSort('-created_at')
        ->paginate($request->query('per_page', config('pagination.default.per_page_limit')));
}

方案二：确保请求参数修改在QueryBuilder初始化前生效 #

如果坚持要通过修改Request来实现，需要直接操作Request的Query存储，确保参数更新能被后续的QueryBuilder读取到：

public function index(Request $request)
{
    // 直接替换整个filter数组
    $request->query->set('filter', ['subject_type' => 'new_value']);

    // 若需要保留其他filter参数，可改用以下写法
    // $filter = $request->query('filter', []);
    // $filter['subject_type'] = 'new_value';
    // $request->query->set('filter', $filter);

    return QueryBuilder::for(User::class)
        ->allowedFilters([AllowedFilter::exact('subject_type')])
        ->allowedSorts(['created_at'])
        ->defaultSort('-created_at')
        ->paginate($request->query('per_page', config('pagination.default.per_page_limit')));
}

测试验证 #

修改后，可在测试用例中添加断言，验证查询确实使用了指定的new_value：

public function test_can_see_activity_log()
{
    $response = $this->getJson('/api/v1/users?filter[subject_type]=App\Models\Post');
    
    // 断言返回的所有数据的subject_type都是new_value
    $response->assertJson(fn ($json) => 
        $json->data->every(fn ($item) => $item->subject_type === 'new_value')
    );
}

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