Spring Boot2 Google OAuth2配置未使用自定义UserService原因咨询

我来帮你捋捋这个问题，你的自定义MyUserService没生效，大概率是Security配置里没把它正确关联到OAuth2登录流程，或者自定义服务的实现细节有遗漏。下面是具体的排查和解决步骤：

1. 检查SecurityConfig的OAuth2登录配置是否正确关联自定义UserService #

你只注入了MyUserService，但如果没在configure(HttpSecurity http)里明确指定它作为OAuth2的用户服务，Spring还是会用默认的实现。正确的配置应该是这样：

@Configuration
@EnableWebSecurity // 别忘了加这个注解开启WebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Autowired
    private MyUserService myUserService;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .anyRequest().authenticated()
                .and()
            .oauth2Login() // 开启OAuth2登录流程
                .userInfoEndpoint() // 配置用户信息获取端点
                    .userService(myUserService); // 绑定你的自定义UserService
    }
}

2. 确保自定义MyUserService的实现正确 #

你需要重写loadUser方法，不仅要调用父类获取Google返回的用户数据，还要把自定义的角色、用户名等信息封装到自定义的OAuth2User实现类里，而不是直接返回父类的结果。示例代码：

@Service // 必须加这个注解，让Spring扫描并管理这个Bean
public class MyUserService extends DefaultOAuth2UserService {

    @Override
    public OAuth2User loadUser(OAuth2UserRequest userRequest) throws OAuth2AuthenticationException {
        // 先获取Google提供的原始用户信息
        OAuth2User googleUser = super.loadUser(userRequest);
        
        // 从Google的属性中提取基础信息（比如name、email）
        String username = googleUser.getAttribute("name");
        String email = googleUser.getAttribute("email");
        
        // 自定义角色（这里可以从数据库/配置中心拉取实际角色，示例用固定角色）
        Set<GrantedAuthority> authorities = Collections.singletonList(new SimpleGrantedAuthority("ROLE_USER"));
        
        // 返回自定义的OAuth2User对象，携带你的自定义数据
        return new CustomOAuth2User(authorities, googleUser.getAttributes(), "sub", username, email);
    }
}

3. 实现自定义的OAuth2User类承载自定义数据 #

你需要创建一个实现OAuth2User接口的类，用来存放你的自定义字段（比如用户名、角色），这样后续在获取Principal时就能拿到这些数据：

public class CustomOAuth2User implements OAuth2User {

    private final Collection<? extends GrantedAuthority> authorities;
    private final Map<String, Object> attributes;
    private final String nameAttributeKey;
    // 自定义字段
    private final String username;
    private final String email;

    public CustomOAuth2User(Collection<? extends GrantedAuthority> authorities,
                            Map<String, Object> attributes,
                            String nameAttributeKey,
                            String username,
                            String email) {
        this.authorities = authorities;
        this.attributes = attributes;
        this.nameAttributeKey = nameAttributeKey;
        this.username = username;
        this.email = email;
    }

    @Override
    public Map<String, Object> getAttributes() {
        return attributes;
    }

    @Override
    public Collection<? extends GrantedAuthority> getAuthorities() {
        return authorities;
    }

    @Override
    public String getName() {
        return attributes.get(nameAttributeKey).toString();
    }

    // 自定义getter方法，方便后续获取数据
    public String getUsername() {
        return username;
    }

    public String getEmail() {
        return email;
    }
}

4. 其他可能的坑 #

• 确认MyUserService上的@Service注解没有遗漏，否则Spring无法注入这个Bean，你的配置自然不会生效。
• 如果项目中有多个Security配置类，可能存在优先级冲突，你可以给SecurityConfig加上@Order(1)注解，确保它优先被加载。
• 检查是否有其他配置（比如过滤器、拦截器）干扰了OAuth2的登录流程。

按照上面的步骤调整后，你应该就能在认证完成后，从Principal对象中获取到自定义的角色、用户名等数据了。

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