Spring WebFlux集成Keycloak OAuth2启动报错：clientRegistrationRepository cannot be null

这个报错的核心原因是Spring Security在构建springSecurityFilterChain时，找不到可用的ClientRegistrationRepository Bean，导致依赖注入失败。以下是针对性的排查和解决步骤：

1. 确认依赖完整性 #

首先检查项目是否引入了Spring Security OAuth2客户端的核心依赖：

• Maven项目（pom.xml）：

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

• Gradle项目（build.gradle）：

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

缺失该依赖时，Spring无法自动配置ClientRegistrationRepository相关组件。

2. 校验配置文件正确性 #

确保application.properties中的Keycloak OAuth2配置完整且准确，示例配置如下：

# 客户端注册配置
spring.security.oauth2.client.registration.keycloak.client-id=你的客户端ID
spring.security.oauth2.client.registration.keycloak.client-secret=你的客户端密钥（保密客户端必填）
spring.security.oauth2.client.registration.keycloak.scope=openid,profile,email
spring.security.oauth2.client.registration.keycloak.authorization-grant-type=authorization_code
spring.security.oauth2.client.registration.keycloak.redirect-uri={baseUrl}/login/oauth2/code/keycloak

# Keycloak提供者配置
spring.security.oauth2.client.provider.keycloak.issuer-uri=http://你的Keycloak地址/realms/你的领域名
spring.security.oauth2.client.provider.keycloak.user-name-attribute=preferred_username

注意：

• issuer-uri必须指向Keycloak领域的有效地址，浏览器访问该地址应能返回OpenID Connect配置JSON；
• 公共客户端可省略client-secret配置项。

3. 检查SecurityConfig配置 #

确保你的SecurityConfig类正确启用OAuth2登录，且未错误覆盖ClientRegistrationRepository：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.web.SecurityFilterChain;

@Configuration
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth
                .anyRequest().authenticated()
            )
            .oauth2Login(oauth2 -> oauth2
                // 无需手动指定clientRegistrationRepository，Spring会自动注入默认Bean
            );
        return http.build();
    }
}

若手动创建ClientRegistrationRepository但未正确初始化，会导致该Bean为空，建议优先使用Spring自动配置的组件。

4. 验证Keycloak服务与客户端配置 #

• 确认Keycloak服务正常运行，issuer-uri可正常访问；
• 登录Keycloak后台检查客户端配置：
  • 客户端Access Type与配置匹配（保密/公共）；
  • 重定向URI与配置中的redirect-uri完全一致；
  • 已开启Authorization Code Flow授权类型。

5. 排查自定义Bean冲突 #

若项目中存在自定义的ClientRegistrationRepository或OAuth2ClientProperties Bean，可能覆盖了Spring自动配置的组件，导致其为空。检查项目中是否有此类自定义代码，确保其正确初始化。

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