Spring Boot配置类报错BeanDefinitionStoreException求助

可能的核心原因 #

• 版本兼容性冲突：主项目中Spring Boot与Spring Security的版本不匹配，导致配置类解析时触发Autowire相关的Bean定义错误，而简化项目使用了兼容版本所以正常运行。
• 配置类未被扫描：SecurityConfig所在包不在Spring Boot主启动类的默认扫描范围内，容器无法识别该配置类，引发加载异常。
• 依赖冗余/冲突：pom.xml中重复引入Spring Security相关依赖，或混入其他安全框架（如Shiro），导致Bean定义加载逻辑混乱。
• 无效Autowire配置：项目中某个Bean（不一定是SecurityConfig）使用了错误的@Autowired配置，比如指定了不存在的默认值，或依赖的Bean未被容器注册。

具体排查与解决步骤 #

1. 统一Spring Boot与Security版本
   Spring Boot父依赖已统一管理Spring Security的版本，无需手动指定Security版本，避免版本不兼容：

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>替换为你的Spring Boot版本，如2.7.15</version>
       <relativePath/>
   </parent>
   
   <dependencies>
       <!-- 仅需引入starter，无需额外指定版本 -->
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-security</artifactId>
       </dependency>
   </dependencies>
   

2. 确保配置类被扫描
   主启动类的@SpringBootApplication默认扫描自身所在包及子包，若SecurityConfig在其他包下，需扩展扫描范围：

   @SpringBootApplication(scanBasePackages = {"com.your.main.package", "com.your.security.config.package"})
   public class YourApplication {
       public static void main(String[] args) {
           SpringApplication.run(YourApplication.class, args);
       }
   }
   

3. 清理冗余依赖

   • 移除pom.xml中重复的Spring Security依赖（如同时引入spring-security-core和spring-boot-starter-security），保留spring-boot-starter-security即可。
   • 删除无关的安全框架依赖，避免冲突。

4. 排查Autowire配置问题

   • 检查所有带@Autowired、@Resource注解的Bean，确认依赖的Bean存在于容器中，无拼写错误。
   • 避免使用无效的Autowire参数，比如@Autowired(required = false)但实际依赖为必需项，或错误指定value属性。

5. 逐步定位差异
   将主项目的依赖、配置、Bean逐步添加到简化项目中，每次添加后启动测试，快速定位引发异常的具体内容。

基础可用的SecurityConfig示例 #

如果配置类本身无语法错误，可参考以下基础配置：

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()
            )
            .formLogin(form -> form.permitAll());
        return http.build();
    }
}

内容的提问来源于stack exchange，提问作者Lucas Brélivet