Spring Boot如何确保commons模块的Bean优先于api模块加载？

你遇到的这个问题其实是Spring Bean初始化顺序的典型场景——虽然你已经在ApiMain里用@ComponentScan包含了两个包，但Spring的组件扫描和Bean创建顺序并不完全跟着包的扫描顺序走。当api模块里的RestController先被初始化时，它依赖的commons模块repository还没被创建，自然就会抛出依赖找不到的错误。下面给你几个靠谱的解决办法：

方法一：用@Import显式导入commons的配置类（简单直接） #

首先在commons模块里创建一个专门的配置类，把整个commons包的组件扫描都放在这里：

package com.example.commons.config;

@Configuration
@ComponentScan(basePackages = "com.example.commons")
public class CommonsConfig {
    // 这里可以额外定义commons模块需要的Bean，或者让@ComponentScan自动扫描所有组件
}

然后修改api模块的启动类，把原来@ComponentScan里的com.example.commons去掉，换成@Import导入上面的配置类：

@SpringBootApplication
@Import(CommonsConfig.class)
@ComponentScan("com.example.api")
public class ApiMain {
    @Bean
    public BCryptPasswordEncoder bCryptPasswordEncoder() {
        return new BCryptPasswordEncoder();
    }

    public static void main(String[] args) {
        SpringApplication.run(ApiMain.class, args);
    }
}

@Import引入的配置类会被Spring优先处理，这样commons模块的所有Bean都会在api模块的Bean之前完成初始化。

方法二：用@DependsOn强制指定单个Bean的依赖顺序 #

如果只有个别RestController依赖commons的Bean，可以直接在RestController上标记@DependsOn，指定它依赖的repository Bean名称：

@RestController
@DependsOn("userRepository") // 替换成你实际的repository Bean名称
public class UserApiController {
    private final UserRepository userRepository;

    // 构造函数注入
    public UserApiController(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    // ... 你的接口方法
}

这样Spring会确保userRepository先被初始化，再创建UserApiController。不过这种方法适合依赖少的场景，依赖多的话会显得繁琐。

方法三：把commons模块做成Spring Boot Starter（推荐长期方案） #

如果这个commons模块需要被多个模块复用，最好把它封装成Spring Boot Starter，让它自动被Spring Boot识别加载：

1. 在commons模块的src/main/resources/META-INF目录下创建spring.factories文件，内容如下：

   org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.example.commons.config.CommonsConfig
   

2. 在api模块的构建文件（pom.xml或build.gradle）中添加commons模块的依赖。
   这样Spring Boot启动时会自动加载commons的自动配置类，不需要在api模块里手动配置扫描或导入，而且自动配置类的优先级默认较高，能完美解决Bean加载顺序的问题。

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