如何让Spring Boot优先加载commons模块的Bean以避免启动失败？

我之前也碰到过类似的Spring组件加载顺序问题，尤其是跨模块依赖Repository和业务Bean时，大量用@DependsOn确实会导致代码冗余且不好维护。这里分享几个更优雅的解决方案：

方案一：用@Import强制优先加载commons配置类 #

这个方法通过显式导入commons模块的配置类，让Spring先处理commons的组件扫描和实例化：

1. 在commons-module中创建一个配置类，专门负责扫描该模块的组件：

package com.example.commons;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan("com.example.commons")
public class CommonsConfig {
}

2. 修改ApiMain，移除原来@ComponentScan中的com.example.commons，改用@Import导入上面的配置类：

package com.example.api;

import com.example.commons.CommonsConfig;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Import;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

@SpringBootApplication
@Import(CommonsConfig.class) // 优先加载commons的配置
public class ApiMain {
    @Bean
    public BCryptPasswordEncoder bCryptPasswordEncoder() {
        return new BCryptPasswordEncoder();
    }

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

原理：@Import注解会让Spring在处理当前配置类（ApiMain）之前，先导入并执行指定配置类的逻辑。这样com.example.commons下的所有组件（包括Mongo Repository）会被优先实例化，之后再处理api-module的Bean，从根源上解决依赖顺序问题。

方案二：将commons模块做成Spring Boot自动配置（推荐） #

如果你的项目是Spring Boot架构，这个方案最符合最佳实践，而且扩展性极强：

1. 同样在commons-module中创建CommonsConfig配置类（和方案一一致）。

2. 在commons-module的src/main/resources目录下创建如下路径和文件：
   META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

文件内容只需要一行：

com.example.commons.CommonsConfig

3. 修改ApiMain，只保留基础的@SpringBootApplication即可，无需额外的@ComponentScan或@Import：

package com.example.api;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

@SpringBootApplication
public class ApiMain {
    @Bean
    public BCryptPasswordEncoder bCryptPasswordEncoder() {
        return new BCryptPasswordEncoder();
    }

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

原理：Spring Boot的自动配置机制会优先加载AutoConfiguration.imports中声明的配置类，优先级高于用户自定义的应用配置。这样commons-module的组件会自动在api-module的Bean之前完成初始化，后续新增commons组件也不需要修改api模块的代码，完全解耦。

为什么原来的@ComponentScan顺序不生效？ #

你之前尝试的@ComponentScan({"com.example.commons", "com.example.api"})看似指定了顺序，但Spring的组件扫描和实例化逻辑并不是严格按照包的声明顺序执行的——尤其是Mongo Repository这类由Spring Data专用处理器解析的组件，扫描时机和普通@Component可能不同，所以单纯调整包顺序无法保证加载优先级。

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