Pest PHP中使用含抽象方法的Trait报错的解决方案

Pest执行测试时会为每个测试文件动态生成独立的测试类，通过uses()引入Trait时，宿主类必须实现Trait定义的所有抽象方法。你当前在文件中定义的全局routeName()函数不属于动态生成的测试类，无法满足抽象方法的实现要求，因此触发类未实现抽象方法的报错。

不需要修改原有Trait的前提下，使用Pest原生提供的方法绑定能力，给动态生成的测试类直接实现routeName()方法即可。

修改后的测试文件代码如下：

<?php

use App\Models\Task;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\Traits\UserScopeEndpointTest;
use function Pest\Laravel\actingAs;
use function Pest\Laravel\get;

// 引入Trait时直接绑定抽象方法的实现
uses(RefreshDatabase::class, UserScopeEndpointTest::class)
    ->method('routeName', fn () => 'tasks.index');

beforeEach(function () {
   $task = Task::factory()->create();
   Task::factory()->create();
   actingAs($task->user);
});


test('user can see all his tasks', function () {
    // 路由名通过测试实例的$this->routeName()调用，和Trait内的调用方式保持一致
    get(route($this->routeName()))->assertStatus(200);
});

关键说明 #

• 删掉你之前写的全局routeName()函数，该函数不属于测试类，无法被Trait内的$this->routeName()识别。
• uses()->method()是Pest专门提供的API，作用是给当前文件动态生成的测试类新增指定方法，完全满足Trait对抽象方法的实现要求。
• 所有自定义测试用例中调用路由名时，统一通过$this->routeName()访问，和Trait内部的调用逻辑保持一致。

可选优化方案 #

如果你有多个测试文件要复用这个Trait，可以改造Trait去掉抽象方法定义，改用测试上下文传递路由名，避免每个文件重复写方法绑定：
修改后的Trait代码：

<?php

namespace Tests\Traits;

use Illuminate\Support\Facades\Route;

trait UserScopeEndpointTest
{
    /** @test */
    public function ep_contains_auth_middleware()
    {
        $this->assertTrue(in_array('auth',
            Route::getRoutes()->getByName($this->routeName)->gatherMiddleware()));
    }

    /** @test */
    public function ep_contains_apply_user_scopes_middleware()
    {
        $this->assertTrue(in_array('applyUserScopes',
            Route::getRoutes()->getByName($this->routeName)->gatherMiddleware()));
    }
}

测试文件中只需要在beforeEach里给测试实例绑定routeName属性即可：

uses(RefreshDatabase::class, UserScopeEndpointTest::class);

beforeEach(function () {
   $this->routeName = 'tasks.index';
   $task = Task::factory()->create();
   Task::factory()->create();
   actingAs($task->user);
});

test('user can see all his tasks', function () {
    get(route($this->routeName))->assertStatus(200);
});

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