添加spring-boot-starter-oauth2-client后Spring Boot上下文加载失败排查

问题原因 #

添加spring-boot-starter-oauth2-client依赖后，Spring Boot会自动启用Spring Security相关配置。Togglz的Spring Boot Starter在检测到Spring Security存在时，会依赖与Security集成的UserProvider实现，但此时自动配置未正确生成该Bean；同时你的依赖中重复声明了spring-boot-starter-actuator，可能引发依赖加载冲突，进一步导致上下文初始化失败。

解决步骤 #

1. 清理重复依赖 #

修改build.gradle，移除重复的spring-boot-starter-actuator声明，保留一行即可：

implementation 'org.springframework.boot:spring-boot-starter-actuator'
implementation "org.springframework.boot:spring-boot-starter-validation"
implementation "org.togglz:togglz-spring-boot-starter:3.2.1"
implementation "org.togglz:togglz-console:3.2.1"
compileOnly 'org.projectlombok:lombok'
annotationProcessor 'org.projectlombok:lombok'
testImplementation 'org.springframework.boot:spring-boot-starter-test'
implementation 'org.springframework.boot:spring-boot-starter-oauth2-client'

2. 显式配置Togglz的UserProvider #

创建配置类，提供UserProvider Bean，可根据需求选择两种实现：

方案一：集成Spring Security用户（推荐生产环境）

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.togglz.core.user.UserProvider;
import org.togglz.spring.security.SpringSecurityUserProvider;

@Configuration
public class TogglzConfig {
    @Bean
    public UserProvider userProvider() {
        // 指定拥有Togglz控制台权限的角色
        return new SpringSecurityUserProvider("ADMIN");
    }
}

方案二：使用简单用户提供者（适合开发环境）

如果不需要关联Spring Security，也可以通过配置文件指定：

# application.properties
togglz.user.provider=org.togglz.core.user.SimpleUserProvider
togglz.user.simple.user-name=admin

3. 配置Spring Security允许访问Togglz控制台 #

添加Security配置类，确保Togglz控制台端点能被正常访问：

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
                .requestMatchers("/togglz-console/**").permitAll() // 开发环境允许无权限访问
                // 其他端点根据业务需求配置权限
                .anyRequest().authenticated()
        );
        return http.build();
    }
}

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