测试环境下如何用Laravel Socialite获取Facebook用户好友列表

问题描述 #

我在Laravel项目的测试环境中，使用Laravel Socialite实现了Facebook账号登录功能，目前已在登录流程中请求了user_friends权限。查阅了Laravel Socialite及Facebook Graph API文档，但仍不清楚如何获取用户的Facebook好友列表；尝试直接调用Graph API但未能与Socialite顺畅集成。

当前认证代码片段 #

public function redirectToProviderFacebook()
{
   return Socialite::driver('facebook')->scopes(['user_friends'])->redirect();
}

public function handleProviderCallbackFacebook(Request $request)
{
    try {
        $user = Socialite::driver('facebook')->stateless()->user();
        $accessToken = $user->token;
        // Get friends
        $response = Http::withToken($accessToken)
            ->get('https://graph.facebook.com/me/friends');

        $friends = $response->json();
        dd($friends);
        $data = User::where('email', $user->email)->first();
        if (is_null($data)) {
            $users['name'] = $user->name;
            $users['email'] = $user->email;
            $users['password'] = Hash::make('password');
            $data = User::create($users);
        }
        Auth::login($data);
        return redirect('dashboard');
    } catch (\Exception $e) {
        // Log the error or return a meaningful message
        Log::error('Facebook OAuth error: ' . $e->getMessage());
        return redirect()->route('login')->with('error', 'Authentication failed.');
    }
}

问题解答 #

1. 测试环境中通过Laravel Socialite获取Facebook好友列表的步骤 #

• 确认user_friends权限已正确请求：你的跳转方法已添加该权限，符合要求，但需注意**user_friends仅返回同样授权过当前应用的好友**
• 复用Socialite的AccessToken：Socialite返回的$user->token是有效的用户访问令牌，可直接用于Graph API请求
• 指定Graph API版本：Facebook会定期废弃旧版本API，必须使用当前支持的稳定版本（如v18.0）避免请求失败
• 解析API返回数据：好友数据存放在响应的data字段中，需正确提取而非直接使用整个JSON响应

2. Facebook开发者控制台的测试环境特定配置 #

• 创建关联测试用户：在后台「测试用户」页面创建多个测试用户，将他们设置为好友，且所有测试用户都要授权登录你的应用——这是测试环境下获取好友数据的前提
• 启用权限：在「权限与功能」页面找到user_friends权限并启用，测试环境无需提交正式审核
• 保持开发模式：确保应用处于「开发模式」，测试用户可不受发布后的权限限制正常使用所有功能
• 配置回调URL：在「产品」→「Facebook登录」→「设置」中，将Laravel项目的回调URL（如https://your-test-domain.com/auth/facebook/callback）添加到「有效的OAuth重定向URI」列表

3. 认证后调用Graph API获取好友的修正示例 #

以下是调整后的完整回调方法，修复了API版本问题、错误处理及数据解析逻辑：

public function handleProviderCallbackFacebook(Request $request)
{
    try {
        $user = Socialite::driver('facebook')->stateless()->user();
        $accessToken = $user->token;
        $graphApiVersion = 'v18.0'; // 使用Facebook当前支持的最新稳定版本

        // 调用Graph API获取好友列表，指定需要的字段
        $response = Http::withToken($accessToken)
            ->get("https://graph.facebook.com/{$graphApiVersion}/me/friends", [
                'fields' => 'id,name,picture{url},email' // 按需指定字段，这里包含头像URL
            ]);

        // 处理API请求失败的情况
        if (!$response->successful()) {
            $errorInfo = $response->json('error', []);
            $errorMsg = $errorInfo['message'] ?? 'Unknown error';
            Log::error('Facebook Graph API error: ' . $errorMsg);
            return redirect()->route('login')->with('error', '无法获取好友列表，请重试');
        }

        $friendsList = $response->json('data', []);
        // 可在此处将好友数据存入数据库或进行其他业务处理
        // 示例：foreach ($friendsList as $friend) { ... }

        // 后续用户登录逻辑
        $existingUser = User::where('email', $user->email)->first();
        if (is_null($existingUser)) {
            $existingUser = User::create([
                'name' => $user->name,
                'email' => $user->email,
                'password' => Hash::make('password')
            ]);
        }
        Auth::login($existingUser);
        return redirect('dashboard');
    } catch (\Exception $e) {
        Log::error('Facebook OAuth error: ' . $e->getMessage());
        return redirect()->route('login')->with('error', '认证失败，请重试');
    }
}

关键提示

• 字段按需指定：默认/me/friends仅返回id和name，若需更多信息（如头像、邮箱），需在请求参数中明确声明
• 测试数据验证：如果测试环境下返回空的好友列表，检查测试用户是否互相为好友且都授权过你的应用

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