Maven转Gradle后junit-jupiter测试引擎无法发现测试问题求助

近期将Maven测试项目转为Gradle后，测试无法正常运行，IntelliJ中执行测试类时报错：TestEngine with ID 'junit-jupiter' failed to discover tests，完整堆栈跟踪如下：

Internal Error occurred.
org.junit.platform.commons.JUnitException: TestEngine with ID 'junit-jupiter' failed to discover tests
    at org.junit.platform.launcher.core.EngineDiscoveryOrchestrator.discoverEngineRoot(EngineDiscoveryOrchestrator.java:160)
    at org.junit.platform.launcher.core.EngineDiscoveryOrchestrator.discoverSafely(EngineDiscoveryOrchestrator.java:132)
    at org.junit.platform.launcher.core.EngineDiscoveryOrchestrator.discover(EngineDiscoveryOrchestrator.java:107)
    at org.junit.platform.launcher.core.EngineDiscoveryOrchestrator.discover(EngineDiscoveryOrchestrator.java:78)
    at org.junit.platform.launcher.core.DefaultLauncher.discover(DefaultLauncher.java:110)
    at org.junit.platform.launcher.core.DefaultLauncher.execute(DefaultLauncher.java:86)
    at org.junit.platform.launcher.core.DefaultLauncherSession$DelegatingLauncher.execute(DefaultLauncherSession.java:86)
    at org.junit.platform.launcher.core.SessionPerRequestLauncher.execute(SessionPerRequestLauncher.java:53)
    at com.intellij.junit5.JUnit5IdeaTestRunner.startRunnerWithArgs(JUnit5IdeaTestRunner.java:71)
    at com.intellij.rt.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:33)
    at com.intellij.rt.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:235)
    at com.intellij.rt.junit.JUnitStarter.main(JUnitStarter.java:54)
Caused by: org.junit.platform.commons.JUnitException: MethodSelector [className = 'tests.SampleTest', methodName = 'test', methodParameterTypes = ''] resolution failed
    at org.junit.platform.launcher.listeners.discovery.AbortOnFailureLauncherDiscoveryListener.selectorProcessed(AbortOnFailureLauncherDiscoveryListener.java:39)
    at org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolution.resolveCompletely(EngineDiscoveryRequestResolution.java:103)
    at org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolution.run(EngineDiscoveryRequestResolution.java:83)
    at org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver.resolve(EngineDiscoveryRequestResolver.java:113)
    at org.junit.jupiter.engine.discovery.DiscoverySelectorResolver.resolveSelectors(DiscoverySelectorResolver.java:46)
    at org.junit.jupiter.engine.JupiterTestEngine.discover(JupiterTestEngine.java:69)
    at org.junit.platform.launcher.core.EngineDiscoveryOrchestrator.discoverEngineRoot(EngineDiscoveryOrchestrator.java:152)
    ... 11 more
Caused by: org.junit.platform.commons.PreconditionViolationException: Could not load class with name: tests.SampleTest
    at org.junit.platform.engine.discovery.MethodSelector.lambda$lazyLoadJavaClass$0(MethodSelector.java:157)
    at org.junit.platform.commons.function.Try$Failure.getOrThrow(Try.java:335)
    at org.junit.platform.engine.discovery.MethodSelector.lazyLoadJavaClass(MethodSelector.java:156)
    at org.junit.platform.engine.discovery.MethodSelector.getJavaClass(MethodSelector.java:135)
    at org.junit.jupiter.engine.discovery.MethodSelectorResolver.resolve(MethodSelectorResolver.java:75)
    at org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolution.lambda$resolve$2(EngineDiscoveryRequestResolution.java:150)
    at java.base/java.util.stream.ReferencePipeline$3$1.accept(ReferencePipeline.java:197)
    at java.base/java.util.ArrayList$ArrayListSpliterator.tryAdvance(ArrayList.java:1602)
    at java.base/java.util.stream.ReferencePipeline.forEachWithCancel(ReferencePipeline.java:129)
    at java.base/java.util.stream.AbstractPipeline.copyIntoWithCancel(AbstractPipeline.java:527)
    at java.base/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:513)
    at java.base/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:499)
    at java.base/java.util.stream.FindOps$FindOp.evaluateSequential(FindOps.java:150)
    at java.base/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234)
    at java.base/java.util.stream.ReferencePipeline.findFirst(ReferencePipeline.java:647)
    at org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolution.resolve(EngineDiscoveryRequestResolution.java:189)
    at org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolution.resolve(EngineDiscoveryRequestResolution.java:126)
    at org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolution.resolveCompletely(EngineDiscoveryRequestResolution.java:92)
    ... 16 more
Caused by: java.lang.ClassNotFoundException: tests.SampleTest
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
    at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:520)
    at org.junit.platform.commons.util.ReflectionUtils.lambda$tryToLoadClass$9(ReflectionUtils.java:831)
    at org.junit.platform.commons.function.Try.lambda$call$0(Try.java:57)
    at org.junit.platform.commons.function.Try.of(Try.java:93)
    at org.junit.platform.commons.function.Try.call(Try.java:57)
    at org.junit.platform.commons.util.ReflectionUtils.tryToLoadClass(ReflectionUtils.java:794)
    at org.junit.platform.commons.util.ReflectionUtils.tryToLoadClass(ReflectionUtils.java:750)
    ... 32 more

示例测试类 #

package tests;

import org.junit.jupiter.api.Test;

public class SampleTest {

    @Test
    public void test() {
        System.out.println("Testing");
    }
}

当前build.gradle配置 #

plugins {
    id 'java'
    id 'maven-publish'
}

repositories {
    mavenCentral()
    maven {
        url = uri('https://repo.maven.apache.org/maven2/')
    }
}

dependencies {
    implementation 'org.seleniumhq.selenium:selenium-java:4.5.0'
    implementation 'org.seleniumhq.selenium:selenium-api:4.5.0'
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.0'
    implementation 'com.sun.mail:javax.mail:1.6.2'
    implementation 'org.apache.commons:commons-email:1.5'
    testImplementation 'org.junit.jupiter:junit-jupiter:5.9.0'
}

group = 'test'
version = '1.0-SNAPSHOT'
description = 'ui-testing'
java.sourceCompatibility = JavaVersion.VERSION_1_8

publishing {
    publications {
        maven(MavenPublication) {
            from(components.java)
        }
    }
}

项目目录结构 #

project
| build.gradle
|
└───src
    |
    └───java
    |   |
    |   └───tests
    |       | SampleTest.java
    |
    └───resources

问题原因 #

从堆栈跟踪最底层的java.lang.ClassNotFoundException: tests.SampleTest可以定位核心问题：测试类未被Gradle正确编译，导致运行时无法加载，具体诱因有两个：

1. 测试类路径不符合Gradle规范：Gradle默认要求测试代码放在src/test/java目录，当前测试类存放在主代码目录src/java中，Gradle的测试任务不会编译主代码目录下的测试类。
2. JUnit依赖配置冗余且缺失引擎启用配置：junit-jupiter已经包含junit-jupiter-api，重复引入无意义；同时未显式配置Gradle使用JUnit Platform运行测试，可能导致测试引擎无法识别测试类。

解决建议 #

1. 调整测试类目录结构 #

将测试类从src/java/tests移动到src/test/java/tests，符合Gradle默认项目结构，确保测试任务能识别并编译测试代码。调整后的结构：

project
| build.gradle
|
└───src
    |
    ├───java
    |   └───[主代码包路径]
    |
    ├───test
    |   └───java
    |       └───tests
    |           | SampleTest.java
    |
    └───resources

2. 优化build.gradle配置 #

• 移除冗余依赖：selenium-java已包含selenium-api，junit-jupiter已包含junit-jupiter-api，删除重复项
• 显式配置JUnit Platform测试任务，确保Gradle使用JUnit 5运行测试

修改后的核心配置片段：

dependencies {
    implementation 'org.seleniumhq.selenium:selenium-java:4.5.0'
    implementation 'com.sun.mail:javax.mail:1.6.2'
    implementation 'org.apache.commons:commons-email:1.5'
    testImplementation 'org.junit.jupiter:junit-jupiter:5.9.0'
}

// 配置测试任务使用JUnit Platform
tasks.named('test') {
    useJUnitPlatform()
}

3. 清理并重新构建 #

在IntelliJ中执行以下操作：

• 运行Gradle的clean任务，清除旧编译产物
• 运行testClasses任务，确保测试类被正确编译
• 重新执行测试类

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