Spring Boot集成Spring Security报错：创建filterChain Bean失败

核心错误信息：

org.springframework.beans.factory.UnsatisfiedDependencyException: 创建类路径资源[com/udacity/jdnd/course3/critter/security/WebSecurityConfiguration.class]中定义的名为'filterChain'的Bean失败：通过方法'filterChain'的参数0表达的依赖不满足；嵌套异常为org.springframework.beans.factory.BeanCreationException: 创建名为'org.springframework.security.config.annotation.web.configuration.HttpSecurityConfiguration.httpSecurity'的Bean失败

• 检查WebSecurity配置类写法
  对应Spring Security版本调整配置方式：

  • Spring Security 5.x及更早：确保类继承WebSecurityConfigurerAdapter，并重写configure(HttpSecurity http)方法
  • Spring Security 6+：用@Configuration配合@Bean定义SecurityFilterChain，示例代码：

    @Configuration
    public class WebSecurityConfiguration {
        @Bean
        public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
            http
                .authorizeHttpRequests(auth -> auth.anyRequest().permitAll())
                .csrf(csrf -> csrf.disable());
            return http.build();
        }
    }
    

  注意HttpSecurity的导入路径必须是org.springframework.security.config.annotation.web.builders.HttpSecurity，不要导入错误的类。

• 排查依赖版本兼容性
  用Spring Boot官方的spring-boot-starter-security依赖，而非单独引入Spring Security的jar包，避免版本不匹配。Maven依赖示例：

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

• 检查关联Bean的有效性
  如果自定义了UserDetailsService、AuthenticationManager等安全相关Bean，确保这些Bean能正常创建：比如标注@Service/@Component注解，没有缺失依赖、配置错误等问题——这些Bean创建失败会间接导致HttpSecurity初始化失败。

• 清理缓存重新构建
  执行mvn clean install（Maven）或gradle clean build（Gradle）清理构建缓存，重启应用，排除IDE或构建缓存导致的类加载异常。

• 查看完整异常栈
  当前给出的是顶层异常，找到完整的异常堆栈信息，里面会包含底层的具体错误原因（比如类找不到、配置属性非法、某Bean依赖缺失等），这是精准定位问题的关键。

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