如何配置Spring Boot Maven Plugin跨模块启动应用执行集成测试

针对你在多模块项目中遇到的问题——无法在独立的test模块中通过Spring Boot Maven Plugin启动SpringBoot2App模块，并且出现java.lang.NoClassDefFoundError缺失org/springframework/boot/SpringApplication类的情况，我整理了可行的配置方案和问题排查要点：

核心配置方案 #

首先确保test模块的pom.xml中包含以下配置，同时保证SpringBoot2App模块已正确编译：

1. 添加SpringBoot2App模块依赖 #

test模块需要依赖SpringBoot2App的编译产物，这样才能访问到应用主类：

<dependencies>
    <!-- 依赖SpringBoot2App模块，范围设为test仅用于集成测试阶段 -->
    <dependency>
        <groupId>你的项目groupId</groupId>
        <artifactId>SpringBoot2App</artifactId>
        <version>${project.version}</version>
        <scope>test</scope>
    </dependency>
    <!-- 保留你已添加的spring-boot-starter-web依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>${spring-boot.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 配置Spring Boot Maven Plugin与Failsafe插件 #

在test模块的<build><plugins>节点下添加以下配置，实现集成测试前后的启动/停止逻辑：

<!-- Failsafe插件：负责执行集成测试 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <executions>
        <execution>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
        </execution>
    </executions>
</plugin>

<!-- Spring Boot Maven Plugin：启动/停止SpringBoot2App -->
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>${spring-boot.version}</version>
    <executions>
        <!-- 预集成测试阶段启动应用 -->
        <execution>
            <id>start-spring-boot-app</id>
            <phase>pre-integration-test</phase>
            <goals>
                <goal>start</goal>
            </goals>
            <configuration>
                <!-- 指定SpringBoot2App的主类 -->
                <mainClass>com.SimpleServiceApplication</mainClass>
                <!-- 显式指向SpringBoot2App的编译类目录，确保插件能找到类文件 -->
                <classesDirectory>${project.basedir}/../SpringBoot2App/target/classes</classesDirectory>
                <!-- 启用fork模式，保证应用在独立进程中运行 -->
                <fork>true</fork>
            </configuration>
        </execution>
        <!-- 集成测试完成后停止应用 -->
        <execution>
            <id>stop-spring-boot-app</id>
            <phase>post-integration-test</phase>
            <goals>
                <goal>stop</goal>
            </goals>
        </execution>
    </executions>
    <!-- 为插件添加依赖，避免类找不到的问题 -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>${spring-boot.version}</version>
        </dependency>
        <dependency>
            <groupId>你的项目groupId</groupId>
            <artifactId>SpringBoot2App</artifactId>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
</plugin>

问题原因分析 #

你之前的配置失效主要有两个核心原因：

1. 类路径不完整：虽然添加了spring-boot-starter-web，但test模块的类路径没有包含SpringBoot2App的主类编译文件，导致SpringApplication找不到（注意：starter-web提供的是框架类，而你的应用主类在SpringBoot2App模块中）。
2. 缺少必要的插件依赖：Spring Boot Maven Plugin本身需要访问Spring Boot相关类，直接在插件内部添加依赖能确保类路径正确。

执行方式 #

在父项目根目录执行以下命令，Maven会自动按依赖顺序编译模块并执行集成测试：

mvn clean verify

如果只想单独执行test模块的集成测试，先确保SpringBoot2App已编译：

mvn clean install -pl SpringBoot2App
mvn verify -pl test

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