Maven install时Failsafe插件集成测试失败求助

问题描述 #

单独执行mvn failsafe:integration-test时，所有集成测试可正常运行；但执行mvn install时，Failsafe插件的集成测试失败，报错信息如下：

TestEngine with ID 'junit-jupiter' failed to discover tests
...
Caused by: java.lang.NoClassDefFoundError: com/mypackage/service/MyObject

当前Failsafe插件的POM配置：

<plugin>
    <artifactId>maven-failsafe-plugin</artifactId>
    <configuration>
        <useModulePath>false</useModulePath>
        <includes>
            <include>**/*IT.java</include>
        </includes>
        <excludes>
            <exclude>**/*Test.java</exclude>
        </excludes>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
        </execution>
    </executions>
</plugin>

使用的JUnit Jupiter版本为5.8.2，降级版本后问题依旧。

可能的原因及解决办法 #

1. 主代码编译产物未加入Failsafe类路径 #

执行mvn install时，Maven按clean→compile→test→package→integration-test的生命周期顺序执行。如果package阶段对产物做了修改（比如重新打包、移除类文件），或者Failsafe未自动引入主代码的class文件，就会出现类找不到的情况。

解决办法：
在Failsafe插件配置中显式添加主代码输出目录到类路径：

<configuration>
    <!-- 原有配置保留 -->
    <additionalClasspathElements>
        <additionalClasspathElement>${project.build.outputDirectory}</additionalClasspathElement>
    </additionalClasspathElements>
</configuration>

2. 多模块项目依赖范围错误 #

如果是多模块项目，集成测试所在模块对包含MyObject的模块依赖范围设为test，会导致打包阶段不包含该依赖，进而在集成测试阶段找不到类。

解决办法：
调整依赖范围为compile或runtime，示例如下：

<dependency>
    <groupId>com.mypackage</groupId>
    <artifactId>service-module</artifactId>
    <version>${project.version}</version>
</dependency>

3. Failsafe插件版本与JUnit Jupiter不兼容 #

默认的Failsafe插件版本可能过低，无法适配JUnit 5.8.2，导致测试引擎无法正常加载类。

解决办法：
指定兼容的Failsafe插件版本（推荐3.0.0-M7及以上）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>3.0.0-M7</version>
    <!-- 原有配置保留 -->
</plugin>

4. 主代码编译不完整 #

如果主代码com/mypackage/service/MyObject在compile阶段未生成class文件，或者生成的文件被误删，也会触发该错误。

解决办法：
执行mvn clean compile，检查target/classes/com/mypackage/service/目录下是否存在MyObject.class文件；若不存在，排查主代码编译报错信息，修复编译问题。

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