如何使用Maven Surefire插件从测试JAR中运行测试？

核心问题分析 #

你遇到的「No tests to run」本质原因是：Surefire默认只会扫描testClassesDirectory指定目录下的测试类，而maven.test.additionalClasspath仅将JAR添加到类路径，并不会让Surefire把JAR作为测试类的扫描源。

方案1：直接指定测试JAR为Surefire的测试类来源 #

修改Surefire插件配置，将testClassesDirectory指向你的test-all.jar文件（而非目录），这是让Surefire扫描JAR内测试类的关键：

插件配置方式（pom.xml）

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.0.0-M9</version>
  <configuration>
    <!-- 指向预构建的测试JAR -->
    <testClassesDirectory>${project.basedir}/path/to/test-all.jar</testClassesDirectory>
    <!-- 保留你的测试用例过滤配置 -->
    <includesFile>${project.basedir}/tests.suite</includesFile>
    <!-- 关闭Manifest-only JAR，避免类加载隔离 -->
    <useManifestOnlyJar>false</useManifestOnlyJar>
    <!-- 启用系统类加载器，确保测试类依赖能被正确加载 -->
    <useSystemClassLoader>true</useSystemClassLoader>
    <!-- Java 9+ 环境添加此配置，避免模块路径类加载问题 -->
    <useModulePath>false</useModulePath>
  </configuration>
</plugin>

命令行临时配置方式

如果不想修改pom.xml，直接用命令行参数指定：

mvn surefire:test -Dsurefire.testClassesDirectory=path/to/test-all.jar -Dsurefire.includesFile=tests.suite -Dsurefire.useManifestOnlyJar=false -Dsurefire.useModulePath=false

方案2：解压测试JAR到标准测试类目录（兼容所有Surefire版本） #

如果直接指定JAR作为testClassesDirectory出现类加载异常，可以先将测试JAR解压到target/test-classes目录，再让Surefire扫描：

添加maven-dependency-plugin配置

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-dependency-plugin</artifactId>
  <version>3.6.0</version>
  <executions>
    <execution>
      <id>unpack-test-jar</id>
      <phase>process-test-classes</phase>
      <goals>
        <goal>unpack</goal>
      </goals>
      <configuration>
        <artifactItems>
          <artifactItem>
            <!-- 替换为你的测试JAR的GAV信息 -->
            <groupId>your.group.id</groupId>
            <artifactId>your.artifact.id</artifactId>
            <version>your.version</version>
            <classifier>tests</classifier> <!-- 如果测试JAR带classifier -->
            <outputDirectory>${project.build.testOutputDirectory}</outputDirectory>
          </artifactItem>
        </artifactItems>
      </configuration>
    </execution>
  </executions>
</plugin>

运行测试

执行以下命令，Surefire会自动扫描解压后的target/test-classes目录：

mvn process-test-classes surefire:test -Dsurefire.includesFile=tests.suite

排查验证步骤 #

如果测试仍未执行，按以下步骤排查：

• 检查测试JAR内容：用jar tf path/to/test-all.jar确认测试类在正确的包路径下，且包含@Test注解的字节码
• 启用调试日志：添加-X参数运行命令，查看Surefire的类加载日志，确认测试类是否被扫描到，以及是否有类加载异常
• 验证测试用例规则：确保tests.suite里的类名与JAR内的类完全匹配，或符合Surefire默认命名规则（如*Test.java）

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