Spring Boot 3.1.3升级后SecurityFilterChain配置不生效问题

针对你遇到的基础模块中SecurityFilterChain配置未正确加载OAuth2组件的问题，以下是几个核心原因分析和对应的排查步骤：

1. 自动配置加载顺序不匹配 #

Spring Boot 3中，自定义SecurityFilterChain的构建依赖于OAuth2相关自动配置类（如OAuth2ClientAutoConfiguration、OAuth2ResourceServerAutoConfiguration）提前初始化完成。如果基础模块的SecurityConfig在这些自动配置类之前加载，会导致构建过滤器链时无法获取到OAuth2相关的Bean（如ClientRegistrationRepository、JwtDecoder），最终链中缺少OAuth2组件。

排查/解决：

• 在基础模块的SecurityConfig上添加@AutoConfigureAfter注解，明确指定依赖的OAuth2自动配置类：

  @Configuration
  @AutoConfigureAfter({OAuth2ClientAutoConfiguration.class, OAuth2ResourceServerAutoConfiguration.class})
  public class SecurityConfig {
      // 配置代码
  }
  

2. 基础模块缺失OAuth2依赖 #

应用模块虽然引入了OAuth2相关依赖，但基础模块的构建文件（pom.xml/build.gradle）中未声明这些依赖，会导致基础模块的类加载器无法找到OAuth2相关类，进而跳过对应的配置逻辑。

排查/解决：

• 检查基础模块的依赖配置，确保添加对应的OAuth2 Starter依赖：
  Maven：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-oauth2-client</artifactId>
  </dependency>
  <!-- 或根据需求添加resource-server依赖 -->
  

  Gradle：

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

3. 条件注解导致OAuth2配置未执行 #

如果基础模块的SecurityConfig中，OAuth2相关配置代码被@ConditionalOnClass等条件注解包裹，而基础模块缺少对应的类依赖，会导致这部分代码不执行，过滤器链自然没有OAuth2组件。

排查/解决：

• 检查SecurityConfig中配置OAuth2的代码块是否带有条件注解，若有，确保基础模块已引入注解中指定的类对应的依赖；
• 临时移除条件注解，测试配置是否能正常加载OAuth2组件，验证问题根源。

4. Bean优先级与多过滤器链冲突 #

应用模块中可能存在其他SecurityFilterChain Bean（比如Spring Boot自动生成的默认链），如果其优先级高于基础模块的链，会导致基础模块的配置被覆盖或不生效。

排查/解决：

• 在基础模块的SecurityConfig的SecurityFilterChain Bean方法上添加@Order(SecurityProperties.BASIC_AUTH_ORDER - 1)注解，提高自定义链的优先级；
• 开启Spring Security debug模式（在application.yml中设置spring.security.debug: true），查看控制台输出的过滤器链详情，确认自定义链是否被加载，以及是否有更高优先级的链覆盖了它。

5. 类加载器隔离问题 #

基础模块作为独立JAR，其类加载器与应用模块可能存在隔离。如果OAuth2相关Bean是在应用模块类加载器中初始化的，基础模块的SecurityConfig无法引用到这些Bean，导致配置失败。

排查/解决：

• 在基础模块的SecurityConfig中尝试@Autowired注入OAuth2核心Bean（如ClientRegistrationRepository），若注入失败，说明类加载器无法找到该Bean，需确保基础模块依赖对应的类；
• 检查基础模块的依赖范围，避免使用provided等会导致类加载器隔离的依赖范围。

内容的提问来源于stack exchange，提问作者Márkus Viktor