使用Gradle运行测试时，JUnit无法识别Kotlin嵌套类中的测试用例

我之前也碰到过一模一样的情况，结合你用的JUnit 5.1、Kotlin 1.2.30和Gradle 4.6版本，问题主要出在嵌套类的定义方式和Gradle的JUnit 5配置上，下面一步步帮你搞定：

1. 嵌套测试类必须用inner修饰 #

JUnit 5要求嵌套测试类必须是非静态的（对应Java的inner class），这样JUnit才能通过外层类的实例来初始化嵌套类。而Kotlin里普通的嵌套类默认是静态的（和Java的static nested class等价），所以JUnit 5根本不会扫描到这类测试。

错误示例（无法识别）： #

class FoundTest {
    @Test
    fun runsFine() {
        // 这个测试能正常被识别并运行
    }

    // 普通嵌套类（静态），JUnit 5找不到它
    class NestedTest {
        @Test
        fun notFoundByJUnit() {
            // 这个测试永远不会被执行
        }
    }
}

正确写法（添加inner关键字）： #

class FoundTest {
    @Test
    fun runsFine() {
        // 正常运行
    }

    // 改为inner类，JUnit 5就能识别了
    inner class NestedTest {
        @Test
        fun nowFoundByJUnit() {
            // 现在这个测试会被Gradle执行
        }
    }
}

2. 确保Gradle正确配置JUnit 5 #

Gradle 4.6本身支持JUnit 5，但必须显式配置让它使用JUnit Platform，否则会默认用JUnit 4的扫描机制（而JUnit 4完全不支持嵌套测试）。

Groovy版build.gradle配置： #

plugins {
    id 'org.jetbrains.kotlin.jvm' version '1.2.30'
    id 'java-library'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8"
    // JUnit 5核心API依赖
    testImplementation "org.junit.jupiter:junit-jupiter-api:5.1.0"
    // JUnit 5运行时引擎，必须加否则测试跑不起来
    testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:5.1.0"
    // Kotlin适配JUnit 5的依赖，处理internal可见性问题
    testImplementation "org.jetbrains.kotlin:kotlin-test-junit5"
}

test {
    // 关键：告诉Gradle用JUnit Platform运行测试
    useJUnitPlatform()
    // 可选：打印测试执行日志，方便排查问题
    testLogging {
        events 'passed', 'skipped', 'failed'
    }
}

Kotlin DSL版build.gradle.kts配置： #

plugins {
    kotlin("jvm") version "1.2.30"
    `java-library`
}

repositories {
    mavenCentral()
}

dependencies {
    implementation(kotlin("stdlib-jdk8"))
    testImplementation("org.junit.jupiter:junit-jupiter-api:5.1.0")
    testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.1.0")
    testImplementation("org.jetbrains.kotlin:kotlin-test-junit5")
}

tasks.test {
    useJUnitPlatform()
    testLogging {
        events("passed", "skipped", "failed")
    }
}

3. 额外注意事项 #

• 不用刻意把测试类/方法改成public：Kotlin默认的internal可见性，配合kotlin-test-junit5依赖，JUnit 5可以正常识别。
• 外层测试类不能是抽象类：JUnit 5无法实例化抽象类，所以外层类必须是普通的非抽象类。

做完上面的修改后，重新运行./gradlew test，嵌套类里的测试用例应该就能被识别并执行了。

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