Spring Boot集成OAuth2时clientRegistrationRepository抛出BASIC异常求助

1. 检查依赖版本匹配性 #

Spring Boot的starter会自动管理依赖版本，不要手动指定OAuth2相关依赖的版本。确保你的构建文件中只引入官方的OAuth2客户端starter：

• Maven：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-oauth2-client</artifactId>
</dependency>

• Gradle：

implementation 'org.springframework.boot:spring-boot-starter-oauth2-client'

移除所有单独引入的spring-security-oauth2、spring-security-oauth2-autoconfigure这类独立依赖，避免版本冲突引发字段缺失。

2. 替换自定义CommonOAuth2Provider枚举 #

Spring Boot已经内置了org.springframework.security.oauth2.client.registration.CommonOAuth2Provider枚举，包含Google、Facebook等主流服务商的预配置。你自定义的枚举可能和官方类存在字段冲突，直接使用官方枚举即可：

ClientRegistration googleReg = CommonOAuth2Provider.GOOGLE.getBuilder("google")
        .clientId("你的Google客户端ID")
        .clientSecret("你的Google客户端密钥")
        .build();

3. 调整配置类用途 #

如果你的需求是接入第三方OAuth2登录（作为客户端），不需要编写AuthorizationServerConfig——这个类用于搭建OAuth2授权服务器，客户端场景应该用SecurityFilterChain配置认证逻辑：

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth.anyRequest().authenticated())
            .oauth2Login(Customizer.withDefaults());
        return http.build();
    }
}

4. 清理冗余配置与依赖 #

• 运行依赖树命令排查冲突：
  • Maven：mvn dependency:tree
  • Gradle：./gradlew dependencies
    找到重复或版本不一致的Spring Security/OAuth2依赖，直接移除冲突项。
• 简化application.properties，只保留必要的客户端配置：

spring.security.oauth2.client.registration.google.client-id=你的ID
spring.security.oauth2.client.registration.google.client-secret=你的密钥
spring.security.oauth2.client.registration.facebook.client-id=你的ID
spring.security.oauth2.client.registration.facebook.client-secret=你的密钥

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