如何排查并解决全局Spring单例Bean多次初始化问题？

排查步骤 #

• 检查所有配置类的扫描范围：确认Config2到Config6是否也包含@ComponentScan注解，且扫描路径与Config1重叠。如果多个配置类重复扫描同一包，会导致同一个Bean被多次注册为不同的Bean定义，进而触发多次初始化。
• 开启Spring调试日志：将org.springframework.beans.factory包的日志级别设为DEBUG，跟踪Bean的创建流程，查看每个实例对应的Bean定义来源，确认是哪个配置类触发了重复初始化。
• 核对Bean名称：检查是否存在同一类被标注了不同的@Component名称，或者Spring自动生成的Bean名称不一致，导致同一个类被识别为多个独立Bean。
• 检查上下文层次：确认应用中是否存在多个ApplicationContext（比如根上下文和Servlet子上下文、多DispatcherServlet上下文），单例Bean会在每个上下文内被初始化一次。

修复建议 #

• 统一扫描配置：将所有@ComponentScan集中到一个配置类（比如Config1），其他配置类移除@ComponentScan注解，仅保留各自的@Bean定义或其他业务注解。如果其他配置类需要扫描特定包，确保路径不与主扫描范围重叠。
• 用@Import替代多次register：在Config1中通过@Import引入Config2到Config6，然后在初始化时仅注册Config1类，让Spring统一处理配置依赖，避免重复扫描。
  修改后的AppInitializer代码：

  public void onStartup(ServletContext container) throws ServletException {
      AnnotationConfigWebApplicationContext rootContext = new AnnotationConfigWebApplicationContext();
      rootContext.register(Config1.class);
      rootContext.refresh();
  }
  

  Config1添加Import注解：

  @Import({Config2.class, Config3.class, Config4.class, Config5.class, Config6.class})
  @EnableTransactionManagement
  @ComponentScan({ 
      "com.myapp.svc.*", 
      "com.myapp.tools.*", 
      "com.myapp.core", 
      "com.myapp.notification.*",
      "com.myapp.jdbc.*", 
      "com.myapp.spring", 
      "com.myapp.exceptions.svc", 
      "com.myapp.exceptions.svc.dao" })
  public class Config1 {
      // 原配置内容
  }
  

• 排除重复扫描的Bean：如果必须保留多个@ComponentScan，可通过excludeFilters排除已被其他配置类扫描的Bean，避免重复注册。示例：

  @ComponentScan(
      basePackages = "com.myapp.xxx",
      excludeFilters = @Filter(type = FilterType.ASSIGNABLE_TYPE, value = SomeStatefulFactoryImpl.class)
  )
  

• 验证Bean定义唯一性：检查是否有其他配置类通过@Bean显式定义了同一类的实例，这种情况会与@Component扫描生成的Bean定义冲突，导致多次初始化。
• 检查依赖Bean状态：确认@DependsOn标注的依赖Bean（如configPropertiesService、sqlDialectFactory）是否存在重复初始化，依赖Bean的重复创建会间接触发当前Bean的多次初始化。

内容的提问来源于stack exchange，提问作者pojo-guy