Laravel控制器模拟用户时getId()返回空串的测试问题

问题重现 #

控制器代码：

public function getMyStuff(Request $request)
{
    $user = Auth::user();
    var_dump($user->getId());  // 调试输出 'string(0) ""'

    $stuff = Cache::remember(self::$stuffCacheKeyPrefix . $user->getId(), 300, function () use ($request) {
        return /* 涉及当前用户的业务逻辑 */
    });

    return response()->json($stuff);
}

测试代码：

$user = Mockery::mock(User::class);
$user->shouldReceive('getId')->andReturn("123");

// 直接调用能正常返回string(3) "123"
var_dump($user->getId()); die;

// 但发起请求后控制器内getId返回空串
$response = $this->actingAs($user)->get('/me');

问题原因 #

Laravel的actingAs方法要求传入的用户实例实现Illuminate\Contracts\Auth\Authenticatable接口，框架在认证流程中依赖该接口的getAuthIdentifier()方法识别用户ID，而非自定义的getId()方法。你仅Mock了getId()，但未处理认证接口要求的方法，导致Auth系统无法正确识别用户，最终控制器内的用户实例ID为空。

解决方法 #

方法1：正确Mock认证接口方法 #

同时MockgetAuthIdentifier()和自定义的getId()：

$user = Mockery::mock(User::class);
$user->shouldReceive('getAuthIdentifier')->andReturn('123');
$user->shouldReceive('getId')->andReturn('123');

$this->actingAs($user)->get('/me');

方法2：使用部分Mock保留模型原有逻辑 #

如果你的getId()方法是直接返回模型的id属性，可使用makePartial()创建部分Mock，直接设置id属性：

$user = Mockery::mock(User::class)->makePartial();
$user->id = 123;

$this->actingAs($user)->get('/me');

方法3：使用工厂创建真实用户实例（推荐） #

除非必须Mock用户行为，否则优先用Laravel工厂创建真实用户，避免Mock接口遗漏问题：

$user = User::factory()->create(['id' => 123]);

$this->actingAs($user)->get('/me');

验证步骤 #

在控制器中临时添加调试代码，确认认证接口方法的返回值：

var_dump($user->getAuthIdentifier());

若返回空，说明未正确MockgetAuthIdentifier()，按照上述方法调整即可。

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