Spring Boot多OAuth2身份提供商仅@Primary Bean生效问题求助

你的问题核心是错误拆分了OAuth2核心配置Bean，导致Spring Security无法同时识别多个身份提供商。下面是具体问题分析和修复方案：

问题根源 #

1. 你创建了两个独立的ClientRegistrationRepository，每个仅包含一个提供商，而Spring Security需要一个包含所有提供商的单一仓库来支持多提供商认证。
2. 分开定义的OAuth2AuthorizedClientService各自只能处理对应提供商的授权信息，切换@Primary时只有对应服务能正常工作。
3. WebSecurity配置中硬绑定了Google的专属配置，授权请求解析器和仓库都只指向Google，自然无法识别GitHub。

修复方案 #

1. 重构Oauth2ClientConfiguration.java，创建单一的多提供商仓库 #

将GitHub和Google的配置合并到同一个ClientRegistrationRepository中：

@Configuration
public class Oauth2ClientConfiguration {

    @Bean
    public ClientRegistrationRepository clientRegistrationRepository() {
        // GitHub 配置
        ClientRegistration github = ClientRegistration.withRegistrationId("github")
                .clientId("GITHUB_CLIENT_ID")
                .clientSecret("GITHUB_CLIENT_SECRET")
                .authorizationGrantType(AuthorizationGrantType.AUTHORIZATION_CODE)
                .redirectUriTemplate("{baseUrl}/login/oauth2/code/{registrationId}")
                .scope("user")
                .authorizationUri("https://github.com/login/oauth/authorize")
                .tokenUri("https://github.com/login/oauth/access_token")
                .userInfoUri("https://api.github.com/user")
                .userNameAttributeName("id")
                .clientName("GitHub")
                .build();

        // Google 配置
        ClientRegistration google = ClientRegistration.withRegistrationId("google")
                .clientId("GOOGLE_CLIENT_ID")
                .clientSecret("GOOGLE_CLIENT_SECRET")
                .clientAuthenticationMethod(ClientAuthenticationMethod.CLIENT_SECRET_BASIC)
                .authorizationGrantType(AuthorizationGrantType.AUTHORIZATION_CODE)
                .redirectUri("{baseUrl}/login/oauth2/code/{registrationId}")
                .scope("openid", "profile", "email", "address", "phone")
                .authorizationUri("https://accounts.google.com/o/oauth2/v2/auth")
                .tokenUri("https://www.googleapis.com/oauth2/v4/token")
                .userInfoUri("https://www.googleapis.com/oauth2/v3/userinfo")
                .userNameAttributeName(IdTokenClaimNames.SUB)
                .jwkSetUri("https://www.googleapis.com/oauth2/v3/certs")
                .clientName("Google")
                .build();

        // 将两个提供商注册到同一个内存仓库
        return new InMemoryClientRegistrationRepository(github, google);
    }
}

2. 删除OAuth2ClientServiceConfig.java #

不需要单独为每个提供商创建授权客户端服务，Spring Security会自动基于上面的ClientRegistrationRepository生成默认的InMemoryOAuth2AuthorizedClientService。如果需要自定义，也只需创建一个全局Bean：

// 可选：如果需要自定义授权客户端服务，保留此配置；否则直接删除整个类
@Configuration
public class OAuth2ClientServiceConfig {

    @Bean
    public OAuth2AuthorizedClientService authorizedClientService(ClientRegistrationRepository clientRegistrationRepository) {
        return new InMemoryOAuth2AuthorizedClientService(clientRegistrationRepository);
    }
}

3. 修改WebSecurityConfig.java，适配多提供商 #

使用统一的配置，并动态处理不同提供商的认证结果：

@Configuration
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

    @Autowired
    private ClientRegistrationRepository clientRegistrationRepository;

    @Autowired
    private OAuth2AuthorizedClientService authorizedClientService;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
                .addFilterBefore(new CustomSecurityExceptionHandlingFilter(), UsernamePasswordAuthenticationFilter.class)
                .oauth2Login(oauth2 -> oauth2
                        .authorizationEndpoint(auth -> auth
                                // 使用默认授权请求解析器，自动适配所有提供商
                                .authorizationRequestResolver(new DefaultOAuth2AuthorizationRequestResolver(
                                        clientRegistrationRepository, "/oauth2/authorization"
                                ))
                        )
                        .loginPage("/login")
                        .clientRegistrationRepository(clientRegistrationRepository)
                        .successHandler(this::handleOAuth2Login)
                );
    }

    private void handleOAuth2Login(HttpServletRequest request, HttpServletResponse response, Authentication authentication) throws IOException {
        // 动态获取当前认证的提供商ID，避免硬编码
        OAuth2AuthenticationToken oauth2Token = (OAuth2AuthenticationToken) authentication;
        String clientRegistrationId = oauth2Token.getAuthorizedClientRegistrationId();
        String userName = oauth2Token.getName();

        // 从统一服务中加载授权信息
        OAuth2AuthorizedClient authorizedClient = authorizedClientService.loadAuthorizedClient(
                clientRegistrationId, userName
        );

        if (authorizedClient != null) {
            String accessToken = authorizedClient.getAccessToken().getTokenValue();
            // 根据提供商ID区分处理逻辑
            if ("github".equals(clientRegistrationId)) {
                // GitHub用户专属处理
            } else if ("google".equals(clientRegistrationId)) {
                // Google用户专属处理
            }
        }

        // 登录成功后跳转（示例：首页）
        response.sendRedirect("/");
    }
}

关键修改说明 #

• 单一ClientRegistrationRepository：这是多提供商支持的核心，Spring Security通过这个Bean获取所有已配置的身份提供商。
• 统一授权客户端服务：全局管理所有提供商的授权信息，无需拆分。
• 动态识别提供商：通过OAuth2AuthenticationToken获取当前认证的提供商ID，实现多场景动态处理。
• 默认授权请求解析器：自动处理不同提供商的授权路径（如/oauth2/authorization/github和/oauth2/authorization/google）。

内容的提问来源于stack exchange，提问作者Bằng Rikimaru