如何通过mvn test运行项目中所有Kotlin测试用例？

以下是针对问题的具体排查和解决步骤：

1. 确保Kotlin Maven插件正确配置测试编译 #

kotlin-maven-plugin需要明确处理测试源码的编译，否则测试类可能无法生成到target/test-classes目录，导致Surefire无法识别。检查你的插件配置是否包含测试编译目标：

<plugin>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-maven-plugin</artifactId>
    <version>${kotlin.version}</version>
    <executions>
        <!-- 主源码编译 -->
        <execution>
            <id>compile</id>
            <phase>compile</phase>
            <goals>
                <goal>compile</goal>
            </goals>
            <configuration>
                <sourceDirs>
                    <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
                </sourceDirs>
            </configuration>
        </execution>
        <!-- 测试源码编译 -->
        <execution>
            <id>test-compile</id>
            <phase>test-compile</phase>
            <goals>
                <goal>test-compile</goal>
            </goals>
            <configuration>
                <sourceDirs>
                    <sourceDir>${project.basedir}/src/test/kotlin</sourceDir>
                </sourceDirs>
            </configuration>
        </execution>
    </executions>
    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-allopen</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
    </dependencies>
</plugin>

kotlin-maven-allopen插件可选，但若测试类用internal修饰，它可以帮助Surefire更稳定识别这些类（JUnit 5本身支持internal可见性，配置后是额外保障）。

2. 修正Maven Surefire插件配置 #

Surefire插件需要正确适配JUnit 5，且确保能识别Kotlin测试类。建议使用3.0.0+版本的Surefire，并添加JUnit 5引擎依赖：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.2.5</version>
    <configuration>
        <!-- 显式指定测试类匹配规则，覆盖默认规则确保不遗漏 -->
        <includes>
            <include>**/*Test.class</include>
            <include>**/*Tests.class</include>
            <include>**/*Spec.class</include> <!-- 如果你的测试类用Spec结尾 -->
        </includes>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>${junit-jupiter.version}</version>
        </dependency>
    </dependencies>
</plugin>

如果测试类命名不符合上述规则，需在<includes>中添加对应匹配表达式。

3. 检查测试类和方法的可见性与注解 #

• 测试方法：必须添加org.junit.jupiter.api.Test注解，且方法不能是private（Kotlin默认方法为public，手动设为private会被忽略）。
• 测试类：不能是abstract类，可见性至少为internal或public（避免设为private）。
• 特殊测试场景：如果使用@ParameterizedTest、@RepeatedTest等扩展注解，必须添加对应依赖：

  <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-params</artifactId>
      <version>${junit-jupiter.version}</version>
      <scope>test</scope>
  </dependency>
  

  缺少该依赖会导致这类测试方法不被识别。

4. 验证测试类是否被正确编译 #

执行mvn clean compile test-compile后，检查target/test-classes目录，确认所有测试类的.class文件都存在。若某测试类的class文件缺失，需排查：

• src/test/kotlin是否被正确配置为测试源目录
• 测试类的包名是否与目录结构一致

5. 清理缓存并重新运行 #

Maven增量编译可能导致旧class文件残留，执行mvn clean test强制清理并重新构建运行测试，避免缓存干扰。

6. 检查测试类的继承与扩展 #

若测试类继承了父类，确认父类未添加@Ignore注解，也没有自定义扩展拦截测试执行逻辑。

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