Laravel API测试时模型绑定失效，仅字符串参数可用问题求助

我编写了一个调用控制器方法的测试用例：

public function testAuthentication()
{
    $user = $this->createUser();
    $this->actingAs($user)->withoutMiddleware();
    $project = $user->project();
    ...
    $response = $this->post("/api/projects/$project->id/store", [
        'param' => 'testparam'
    ]);
    ...
}

路由定义如下：

Route::group(['prefix' => 'projects'], function () {
    Route::group(['prefix' => '{project}'], function () {
        Route::post('store', [MyController::class, 'store']);
    });
});

控制器的store方法初始定义为：

public function store(Request $request, Project $project): void
{
    dd($project);
    ...
}

启动测试并调试控制器方法时，发现$project为空（无任何属性）；但将方法签名改为：

public function store(Request $request, string $project): void
{
    ...
    MyModel::create([
        ...
        'project_id' => $project
    ]);
})

调试时能获取正确的ID。

通过浏览器正常请求该接口时模型绑定正常，但测试文件中调用仅使用string类型参数才有效，请问这是什么原因？

原因及解决方案 #

问题根源是测试代码里的withoutMiddleware()方法：Laravel的路由模型绑定依赖SubstituteBindings中间件自动将路由参数转换为对应模型实例。当你全局禁用所有中间件时，这个关键中间件也被关闭，导致无法完成模型注入，所以Project $project参数为空。

浏览器正常请求时，SubstituteBindings中间件默认启用，因此模型绑定能正常工作。

有两种解决方式：

• 精准禁用中间件：不要全局禁用所有中间件，只排除不需要的中间件，保留SubstituteBindings：

  // 示例：仅排除认证中间件，根据实际需求调整
  $this->actingAs($user)->withoutMiddleware([Authenticate::class]);
  

• 手动处理模型绑定：如果必须全局禁用中间件，可在控制器中手动查询模型：

  public function store(Request $request, string $projectId): void
  {
      $project = Project::findOrFail($projectId);
      // 后续业务逻辑
  }
  

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