Lumen 10集成Laravel Passport时PHPUnit测试失败问题

问题分析 #

该报错Call to a member function getKey() on null出现在测试环境调用createToken时，核心原因是用户模型实例无法正确获取主键值，结合代码和环境差异，主要诱因包括：

• 重复加载数据库迁移：父类PassportTestCase已引入DatabaseMigrations，子类PassportTest再次引入会导致数据库在用户实例创建后被二次重置，丢失用户记录。
• Passport核心表未正确初始化：测试环境可能未执行Passport的oauth系列表迁移，导致创建令牌时缺少必要表结构支撑。
• 测试环境Passport配置缺失：未在测试流程中生成Passport所需的加密密钥和客户端记录。

解决方案 #

1. 移除重复的数据库迁移依赖 #

修改PassportTest.php，删除重复的use DatabaseMigrations;：

<?php

use Tests\PassportTestCase;
use Carbon\Carbon;

class PassportTest extends PassportTestCase
{
    // 移除此处的use DatabaseMigrations;

    public function test_it_can_login_if_phone_and_email_verified()
    {
        $this->guestApi("post", "auth/login", ["email" => $this->user->email, "password" => "abcdef"])
            ->seeJson([
                "token_type" => "bearer"
            ])
            ->assertResponseStatus(200);
    }
}

2. 确保Passport迁移在测试中执行 #

在PassportTestCase的setUp方法中，明确执行Passport的迁移文件，保证oauth相关表存在：

public function setUp(): void
{
    parent::setUp();
    
    // 执行Passport迁移
    $this->artisan('migrate', ['--path' => 'vendor/laravel/passport/database/migrations']);
    
    $clientRepository = new ClientRepository();
    $client = $clientRepository->createPersonalAccessClient(
        null,
        'Test Personal Access Client',
        "http://localhost"
    );

    DB::table('oauth_personal_access_clients')->insert([
        'client_id' => $client->id,
        'created_at' => Carbon::now(),
        'updated_at' => Carbon::now(),
    ]);

    // ... 其余用户创建代码
}

3. 恢复passport:install命令执行 #

取消PassportTestCase中passport:install的注释，确保测试环境生成Passport所需的加密密钥和默认客户端：

public function setUp(): void
{
    parent::setUp();
    $this->artisan('passport:install');

    // ... 其余代码
}

4. 验证用户模型的HasApiTokens trait #

确认App\Models\User正确引入Passport的trait，保证令牌创建逻辑正常：

<?php

namespace App\Models;

use Illuminate\Auth\Authenticatable;
use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
use Illuminate\Database\Eloquent\Model;
use Laravel\Passport\HasApiTokens;

class User extends Model implements AuthenticatableContract
{
    use Authenticatable, HasApiTokens;

    // ... 其余模型代码
}

验证步骤 #

1. 清理测试数据库：php artisan migrate:fresh --env=testing
2. 单独运行目标测试：phpunit tests/PassportTest.php

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