多模块SpringBoot项目构建报错：Failed to load ApplicationContext

看起来你在多模块Spring Boot项目里遇到了ApplicationContext加载失败的问题，我来帮你梳理下可能的原因和对应的解决办法：

先明确你的场景 #

• 项目结构：根目录下包含api（Java库）、service（Spring Boot微服务）、util（Java库）三个模块
• 主启动类添加了@SpringBootApplication和@ComponentScan("org.sample")配置
• 执行mvn clean install时，ServiceApplicationTests的contextLoads方法报错，提示无法加载ApplicationContext

可能的原因及解决办法 #

1. 组件扫描范围不匹配

虽然你手动指定了@ComponentScan("org.sample")，但要确认：

• api、util模块里的所有类是不是都在org.sample这个根包路径下？比如org.sample.api、org.sample.util这种结构是没问题的，但如果某个模块的类在别的包下，Spring就扫不到对应的Bean了。
• 另外要注意：@SpringBootApplication本身已经自带了@ComponentScan（默认扫描主类所在包及其子包），如果你主类在org.sample.microservices.core.service，手动指定org.sample是扩大了扫描范围，但一定要保证所有需要被Spring管理的组件都在这个范围内。

如果有组件不在org.sample下，可以调整扫描范围，比如：

@ComponentScan(basePackages = {"org.sample", "com.other.package"})
@SpringBootApplication
public class SampleServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(SampleServiceApplication.class, args);
    }
}

2. 多模块依赖未正确配置

你需要检查service模块的pom.xml，确认是否正确引入了api和util模块的依赖，比如：

<dependencies>
    <dependency>
        <groupId>org.sample</groupId>
        <artifactId>api</artifactId>
        <version>${project.version}</version>
    </dependency>
    <dependency>
        <groupId>org.sample</groupId>
        <artifactId>util</artifactId>
        <version>${project.version}</version>
    </dependency>
    <!-- 其他Spring Boot依赖 -->
</dependencies>

如果没正确引入，Spring在扫描时找不到api/util里的类，自然会导致上下文加载失败。

3. 测试类配置有问题

检查你的ServiceApplicationTests，确认是否正确添加了@SpringBootTest注解，并且指定了正确的主启动类：

@SpringBootTest(classes = SampleServiceApplication.class)
class ServiceApplicationTests {
    @Test
    void contextLoads() {
        // 测试逻辑
    }
}

如果测试类没指定主类，或者指定的路径不对，就会无法加载ApplicationContext。

4. Maven模块构建顺序异常

多模块项目执行mvn clean install时，必须保证api和util先被构建完成，service才能正常依赖它们。你可以检查根目录的pom.xml里的modules节点，确保顺序正确：

<modules>
    <module>util</module>
    <module>api</module>
    <module>service</module>
</modules>

Maven会按照这个顺序依次构建模块，避免出现依赖模块未编译的问题。

5. 组件未添加Spring注解

最后确认api和util模块里需要被Spring管理的类，是不是都添加了正确的注解？比如@Component、@Service、@Repository、@Configuration这些，如果类没有加注解，就算扫描范围正确，Spring也不会把它们纳入上下文。

备注：内容来源于stack exchange，提问作者tyyiplite