在Maven中运行Kotlintest遇异常：仅单个测试执行问题求助

我之前也碰到过类似的糟心事，大概率是Maven Surefire插件配置、测试类命名规则或者依赖兼容的问题，给你几个实用的排查方向：

1. 修正Maven Surefire插件配置 #

Kotlintest需要特定的Surefire配置才能识别所有测试类，确保你的pom.xml里有如下正确设置：

<build>
    <plugins>
        <!-- Surefire插件配置，负责执行测试 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.1.2</version> <!-- 建议用最新稳定版 -->
            <configuration>
                <includes>
                    <include>**/*Test.kt</include> <!-- 匹配所有以Test结尾的Kotlin测试类 -->
                    <include>**/*Spec.kt</include> <!-- 如果用Spec风格的测试，必须加上这个 -->
                </includes>
                <useModulePath>true</useModulePath>
            </configuration>
            <dependencies>
                <dependency>
                    <groupId>org.junit.platform</groupId>
                    <artifactId>junit-platform-surefire-provider</artifactId>
                    <version>1.9.3</version>
                </dependency>
            </dependencies>
        </plugin>
        <!-- Kotlin编译插件，确保测试代码被正确编译 -->
        <plugin>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-plugin</artifactId>
            <version>1.9.20</version> <!-- 版本要和你的Kotlintest依赖匹配 -->
            <executions>
                <execution>
                    <id>compile</id>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                    <configuration>
                        <sourceDirs>
                            <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
                        </sourceDirs>
                    </configuration>
                </execution>
                <execution>
                    <id>test-compile</id>
                    <goals>
                        <goal>test-compile</goal>
                    </goals>
                    <configuration>
                        <sourceDirs>
                            <sourceDir>${project.basedir}/src/test/kotlin</sourceDir>
                        </sourceDirs>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 确认测试类的命名与结构规范 #

• 所有测试类必须遵循*Test.kt或*Spec.kt的命名规则，这样Surefire插件才能扫描到它们
• 嵌套包的测试类要放在src/test/kotlin对应的路径下，比如com/myapp/tests的测试类，必须放在src/test/kotlin/com/myapp/tests目录中
• 测试类要继承Kotlintest的基类，比如StringSpec、FunSpec或者BehaviorSpec，不能是普通的Kotlin类

3. 检查Kotlintest依赖的版本兼容性 #

确保你的Kotlintest依赖和JUnit平台版本匹配，比如：

<dependencies>
    <dependency>
        <groupId>io.kotest</groupId>
        <artifactId>kotest-runner-junit5-jvm</artifactId>
        <version>5.6.2</version> <!-- 建议用最新稳定版 -->
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.kotest</groupId>
        <artifactId>kotest-assertions-core-jvm</artifactId>
        <version>5.6.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

4. 手动强制扫描所有测试 #

如果配置没问题但还是只跑单个测试，可以试试用命令行参数强制扫描：

mvn clean test -Dsurefire.includes=**/*Test.kt,**/*Spec.kt

要是还解决不了，你可以把测试类的目录结构和pom.xml的关键部分贴出来，这样更容易精准定位问题。

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