Gradle 4.6搭配JUnit 5时，`-Dtest.single`参数无法使用？

你遇到的问题核心是Gradle版本迭代后旧参数被废弃，再结合JUnit 5的配置要求，导致命令无法定位到指定测试。下面一步步帮你解决：

核心原因：-Dtest.single已被废弃 #

从Gradle 4.0开始，官方就彻底弃用了-Dtest.single这个系统属性，取而代之的是功能更灵活的--tests命令行选项。这就是你执行原命令后提示"找不到匹配测试"的直接原因。

正确的命令写法 #

把旧参数替换成--tests即可，针对你的场景：

• 运行单个测试类：

gradle clean test --tests junittest.SampleTests

• 运行那个名为failingTest的单个测试方法：

gradle clean test --tests junittest.SampleTests.failingTest

另外--tests还支持通配符，比如要运行junittest包下所有测试，可写--tests "junittest.*"，适配更多测试过滤场景。

额外检查：JUnit 5的Gradle配置是否正确 #

如果配置不到位，Gradle可能无法识别JUnit 5的测试类，也会触发找不到测试的报错。确保你的build.gradle包含如下配置：

plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

dependencies {
    // JUnit 5 核心API依赖
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.3.2'
    // JUnit 5 测试引擎依赖
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.3.2'
}

test {
    // 告诉Gradle使用JUnit Platform运行测试
    useJUnitPlatform()
}

注意Gradle 4.6对JUnit 5的兼容上限是Jupiter 5.3.x，不要用过高版本的JUnit 5，避免出现兼容性问题。

最后验证：测试类的路径与拼写 #

确认你的SampleTests.java确实放在src/test/java/junittest/目录下，包名junittest和类名SampleTests的拼写、大小写完全正确——Java是大小写敏感的，哪怕一个字母出错都会导致测试无法被定位。

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