Spring多子模块跨模块注入时Bean无法加载问题如何解决？

核心原因说明 #

绝大多数该场景下的失败是因为显式配置@ComponentScan时覆盖了Spring Boot默认的扫描范围：当你在test-server启动类上仅指定扫描test-client的包com.client.test时，Spring会放弃扫描启动类所在的test-server根包com.demo.test，导致test-server自身的Bean没有被注册到上下文，test-client的Bean注入时自然找不到对应的依赖。

具体解决方法 #

• 方案1：调整@ComponentScan的扫描范围，同时包含两个模块的根包
  直接在test-server的启动类/配置类上配置多包扫描，不要漏扫test-server自身的包：

  @SpringBootApplication
  @ComponentScan(basePackages = {"com.demo.test", "com.client.test"})
  public class TestServerApplication {
      public static void main(String[] args) {
          SpringApplication.run(TestServerApplication.class, args);
      }
  }
  

• 方案2：使用@Import注解精准导入需要的Bean
  如果不需要扫描test-client的所有类，可直接导入指定的Bean类，不会影响test-server默认的扫描逻辑：

  @SpringBootApplication
  @Import(com.client.test.service.DemoService.class)
  public class TestServerApplication {
      // 启动逻辑
  }
  

• 方案3：处理循环依赖场景
  如果两个模块的Bean存在互相依赖的情况，使用构造注入时会触发初始化失败，可在依赖注入位置添加@Lazy注解延迟依赖初始化：

  @Service
  public class DemoService {
      // 字段注入加@Lazy
      @Lazy
      @Autowired
      private TestServerBean testServerBean;
      
      // 构造注入加@Lazy
      public DemoService(@Lazy TestServerBean testServerBean) {
          this.testServerBean = testServerBean;
      }
  }
  

补充排查点 #

• 确认test-client模块的DemoService上添加了@Service/@Component等Bean注册注解
• 检查DemoService上没有添加@ConditionalOnMissingBean、@ConditionalOnClass等条件注解，避免因条件不满足导致Bean未注册
• 确认build.gradle中test-client的依赖声明为implementation project(':test-client')，不要使用compileOnly，避免运行时类缺失

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