基于Spring Security OAuth2 Client获取Facebook更多用户资料的问题

我来帮你搞定这个问题！你已经成功实现了Facebook登录，但只拿到ID和姓名，想要获取个人资料链接、头像等信息，其实只需要调整两个关键配置：指定Facebook要返回的字段，以及正确提取这些字段。以下是具体步骤：

1. 调整application.properties配置 #

首先，你需要在配置文件里明确告诉Facebook你需要哪些用户字段，同时确保scope包含必要的权限（public_profile已经覆盖了头像、资料链接这些基础信息，如果需要邮箱可以加上email）：

# Facebook客户端基础配置
spring.security.oauth2.client.registration.facebook.client-id=你的Facebook应用ID
spring.security.oauth2.client.registration.facebook.client-secret=你的Facebook应用密钥
spring.security.oauth2.client.registration.facebook.scope=public_profile,email
spring.security.oauth2.client.registration.facebook.redirect-uri={baseUrl}/login/oauth2/code/{registrationId}

# 关键：指定Facebook返回的字段，以及Graph API版本（避免旧版本兼容性问题）
spring.security.oauth2.client.provider.facebook.user-info-uri=https://graph.facebook.com/v18.0/me?fields=id,name,first_name,last_name,link,picture.width(200)
spring.security.oauth2.client.provider.facebook.user-name-attribute=id

这里的fields参数是核心：我们明确要求返回link（个人资料链接）、picture（头像，指定宽度200px），还有基础的姓名、ID等信息。

2. 提取并使用额外的用户信息 #

你有两种方式获取这些字段：直接在控制器解析，或者自定义用户服务统一处理。

方式一：控制器中直接解析属性 #

在需要获取用户信息的控制器里，通过@AuthenticationPrincipal拿到OAuth2User对象，然后解析嵌套的属性：

import org.springframework.security.core.annotation.AuthenticationPrincipal;
import org.springframework.security.oauth2.core.user.OAuth2User;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;

@RestController
public class UserProfileController {

    @GetMapping("/user-profile")
    public Map<String, Object> getUserProfile(@AuthenticationPrincipal OAuth2User oAuth2User) {
        Map<String, Object> profile = new HashMap<>(oAuth2User.getAttributes());
        
        // 解析头像URL（Facebook返回的picture是嵌套对象）
        Map<String, Object> pictureData = (Map<String, Object>) profile.get("picture");
        Map<String, Object> pictureDetail = (Map<String, Object>) pictureData.get("data");
        profile.put("avatarUrl", pictureDetail.get("url"));
        
        // 这里可以直接返回处理后的资料，或者存入数据库
        return profile;
    }
}

方式二：自定义OAuth2UserService统一处理 #

如果需要在登录时就把这些信息存入数据库，或者统一处理用户属性，可以自定义用户服务：

import org.springframework.security.core.authority.SimpleGrantedAuthority;
import org.springframework.security.oauth2.client.userinfo.DefaultOAuth2UserService;
import org.springframework.security.oauth2.client.userinfo.OAuth2UserRequest;
import org.springframework.security.oauth2.core.OAuth2AuthenticationException;
import org.springframework.security.oauth2.core.user.DefaultOAuth2User;
import org.springframework.security.oauth2.core.user.OAuth2User;
import org.springframework.stereotype.Service;

import java.util.Collections;
import java.util.Map;

@Service
public class CustomFacebookUserService extends DefaultOAuth2UserService {

    @Override
    public OAuth2User loadUser(OAuth2UserRequest userRequest) throws OAuth2AuthenticationException {
        OAuth2User originalUser = super.loadUser(userRequest);
        Map<String, Object> attributes = originalUser.getAttributes();
        
        // 解析并添加头像URL到属性中
        Map<String, Object> pictureData = (Map<String, Object>) attributes.get("picture");
        String avatarUrl = ((Map<String, Object>) pictureData.get("data")).get("url").toString();
        attributes.put("avatarUrl", avatarUrl);
        
        // 返回自定义的用户对象（也可以换成你自己的User实体类）
        return new DefaultOAuth2User(
                Collections.singletonList(new SimpleGrantedAuthority("ROLE_USER")),
                attributes,
                "id"
        );
    }
}

然后在Security配置类中指定这个自定义服务：

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.oauth2.client.userinfo.OAuth2UserService;

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    private final OAuth2UserService customFacebookUserService;

    public SecurityConfig(OAuth2UserService customFacebookUserService) {
        this.customFacebookUserService = customFacebookUserService;
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
                .authorizeRequests()
                .anyRequest().authenticated()
                .and()
                .oauth2Login()
                .userInfoEndpoint()
                .userService(customFacebookUserService); // 绑定自定义用户服务
    }
}

3. 注意事项 #

• 确保你的Facebook开发者应用中，public_profile权限是开启的（默认就有，不需要额外审核）。
• Graph API版本号可以根据Facebook官方最新版本调整（比如当前是v18.0），避免因版本过期导致字段获取失败。
• 如果需要获取更多敏感信息（比如生日、性别），需要在scope中添加对应的权限，并且提交Facebook审核。

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