Laravel 11集成LinkedIn登录后无法重定向回应用问题

问题详情 #

使用Laravel 11 + Socialite开发LinkedIn登录功能，配置了跳转LinkedIn登录的端点和回调端点。预期用户登录LinkedIn后自动重定向回应用，但实际登录成功后停留在LinkedIn的空白页面，URL为：

https://www.linkedin.com/oauth/v2/login-success?app_id=223222338&auth_type=AC&flow=%7B%22state%22%3A%22nyjguHjmyBKUABGUwXTQdEGNjzI8jZzLofZlWwTk%22%2C%22creationTime%22%3A1734052104859%2C%22appId%22%3A223222338%2C%22authorizationType%22%3A%22OAUTH2_AUTHORIZATION_CODE%22%2C%22redirectUri%22%3A%22http%3A%2F%2Flocalhost%3A5173%2Flinkedin%2Fcallback%22%2C%22currentStage%22%3A%22LOGIN_SUCCESS%22%2C%22currentSubStage%22%3A0%2C%22authFlowName%22%3A%22generic-permission-list%22%2C%22scope%22%3A%22openid+profile+email%22%7D

已确认的配置：

• config/services.php配置：

'linkedin-openid' => [
    'client_id' => env('LINKEDIN_CLIENT_ID'),
    'client_secret' => env('LINKEDIN_CLIENT_SECRET'),
    'redirect' => 'http://localhost:5173/linkedin/callback',
]

• LinkedIn开发者后台已配置相同的重定向URL
• 生成登录链接的服务代码：

class LinkedInAuthLinkService
{
    public function execute(): string
    {
        $state = Str::random(40);
        Cache::put("linkedin_state_{$state}", auth()->id(), now()->addMinutes(60));

        return Socialite::driver(SocialProviders::LINKEDIN)
            ->stateless()
            ->with(['state' => $state])
            ->redirect()
            ->getTargetUrl();
    }
}

解决方案 #

1. 匹配Socialite驱动名称与services.php配置键 #

你的services.php里配置的键是linkedin-openid，但代码中用的是SocialProviders::LINKEDIN作为驱动名，两者必须一致。要么把驱动名改成'linkedin-openid'，要么把services.php的键改成'linkedin'。

修改后的服务代码示例：

return Socialite::driver('linkedin-openid') // 与services.php的键匹配
    ->stateless()
    ->with(['state' => $state])
    ->redirect()
    ->getTargetUrl();

2. 避免手动设置state参数（或确保回调时验证） #

Socialite默认会自动生成并验证state参数，手动设置可能导致LinkedIn端的state验证逻辑异常。建议移除->with(['state' => $state])，改用Socialite自带的state管理：

class LinkedInAuthLinkService
{
    public function execute(): string
    {
        // 移除手动生成的state和Cache存储
        return Socialite::driver('linkedin-openid')
            // ->stateless() // 如果应用是有状态的，建议去掉这个
            ->redirect()
            ->getTargetUrl();
    }
}

如果必须自定义state，需要在回调端点手动验证：

Route::get('/linkedin/callback', function () {
    $state = request()->get('state');
    if (!Cache::has("linkedin_state_{$state}")) {
        abort(403, '无效的state参数');
    }
    Cache::forget("linkedin_state_{$state}");

    $user = Socialite::driver('linkedin-openid')->stateless()->user();
    // 处理用户逻辑
    return redirect('http://localhost:5173/');
});

3. 修正重定向URL指向后端端点 #

当前重定向URL指向前端http://localhost:5173/linkedin/callback，但前端无法直接处理OAuth 2.0的授权码响应。应该将重定向URL改为Laravel后端的回调端点，处理完授权逻辑后再重定向到前端。

• 修改services.php的redirect：

'redirect' => 'http://localhost:8000/linkedin/callback', // 假设后端端口是8000

• 在LinkedIn开发者后台同步更新这个URL
• 后端回调路由示例：

Route::get('/linkedin/callback', function () {
    $user = Socialite::driver('linkedin-openid')->user();
    // 执行用户登录/注册逻辑，比如查找或创建用户
    Auth::login($user);
    // 重定向回前端页面
    return redirect('http://localhost:5173/dashboard');
});

4. 检查LinkedIn应用的OAuth配置 #

• 确认在LinkedIn开发者后台的「Auth」>「OAuth 2.0 Settings」中，已启用Authorization Code Flow
• 确保申请的权限（scope）openid profile email已在LinkedIn应用的「Products」中添加并审核通过（部分权限需要LinkedIn审核）
• 验证重定向URL完全一致：包括协议（http/https）、端口、路径，没有多余的斜杠或空格

5. 按需使用stateless模式 #

如果你的应用是无状态的（比如API），才需要->stateless()；如果是传统有状态应用（使用session），建议移除这个方法，Socialite会自动用session存储state参数，避免验证失败。

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