自定义Lumen API认证时出现'Illegal offset type'问题求助

看起来你遇到的这个「对象不能作为数组键」的错误，大概率是因为Lumen的认证配置没有完全初始化，导致AuthManager在解析guard时拿到了非字符串的$name值。我来帮你梳理下可能遗漏的关键步骤：

1. 启用路由认证中间件 #

首先检查bootstrap/app.php里是否取消了认证中间件的注释——这一步很容易被忽略：

$app->routeMiddleware([
    'auth' => App\Http\Middleware\Authenticate::class,
]);

如果没开启这个，auth中间件根本无法生效，更会导致后续guard解析逻辑出错。

2. 创建认证配置文件 #

Lumen默认没有config/auth.php配置文件，你需要手动在项目根目录的config文件夹下创建它（如果config文件夹不存在就先新建），内容参考如下：

<?php

return [
    'defaults' => [
        'guard' => 'api',
        'passwords' => 'users',
    ],

    'guards' => [
        'api' => [
            'driver' => 'token',
            'provider' => 'users',
        ],
    ],

    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\Models\User::class,
        ],
    ],
];

这里把默认guard设为字符串api，和你在AuthServiceProvider里定义的viaRequest('api', ...)逻辑完全对应，确保AuthManager能正确识别guard名称类型。

3. 确认Authenticate中间件逻辑正确 #

打开App\Http\Middleware\Authenticate.php，检查handle方法是否正确处理guard参数：

public function handle($request, Closure $next, $guard = null)
{
    if ($this->auth->guard($guard)->guest()) {
        return response('Unauthorized.', 401);
    }

    return $next($request);
}

当你在路由中使用middleware' => 'auth'时，$guard会取默认值null，此时会自动使用配置文件里的默认guard（也就是api），避免出现非字符串的$name值。

4. 验证AuthServiceProvider的绑定逻辑 #

确保你的AuthServiceProvider中boot方法的viaRequest绑定正确指向api guard：

$this->app['auth']->viaRequest('api', function ($request) {
    // 你的OAuth2自定义验证逻辑示例
    $token = $request->header('Authorization') 
        ? str_replace('Bearer ', '', $request->header('Authorization')) 
        : null;
        
    if (!$token) return null;
    
    // 调用外部OAuth2提供商验证token，验证通过后返回User实例
    return \App\Models\User::where('oauth_access_token', $token)->first();
});

错误根源说明 #

当Lumen缺少config/auth.php配置时，getDefaultDriver()无法返回正确的字符串类型guard名称，导致解析过程中$name变成了对象，最终触发「对象不能作为数组键」的错误。补上配置文件后，默认guard是明确的字符串api，就能正常作为数组键使用了。

你可以按上述步骤逐一排查，尤其是创建config/auth.php这一步，是Lumen认证流程中容易遗漏的关键环节。

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