Apple Silicon上VSCode中Gradle项目JUnit测试NoClassDefFoundError问题排查

问题根源 #

你的build.gradle存在两个核心问题：

• sourceSets将main和test的源码目录都设为src，导致Gradle无法区分业务代码与测试代码的编译、运行类路径
• 缺少JUnit Jupiter的运行时依赖，仅添加junit-jupiter-api不足以完成测试执行

解决方案 #

1. 修正build.gradle配置 #

修改build.gradle，调整源码集划分并补充必要依赖：

apply plugin: 'java'
sourceCompatibility = 17
version = '1.0.0'
compileJava.options.encoding = 'UTF-8'

repositories {
    mavenCentral()
}

dependencies {
    // JUnit Jupiter API用于编写测试
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.3'
    // JUnit Jupiter引擎用于运行测试，必须添加
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.3'
}

sourceSets {
    main {
        java {
            // 主业务代码指向src/moduleName目录
            srcDir 'src/moduleName'
        }
    }
    test {
        java {
            // 测试代码指向src根目录下的测试类
            srcDir 'src'
            // 排除主业务代码目录，避免重复编译冲突
            exclude 'moduleName/**'
        }
    }
}

// 配置Gradle test任务使用JUnit平台
test {
    useJUnitPlatform()
}

2. 调整项目结构（可选，更规范的做法） #

如果允许修改项目结构，建议遵循Gradle默认标准结构，无需手动配置sourceSets：

fileName
- src
  -- main
     --- java
        ---- moduleName
           ----- maze
  -- test
     --- java
        ---- TestHelper.java
        ---- Testing.java

此时build.gradle可简化为：

apply plugin: 'java'
sourceCompatibility = 17
version = '1.0.0'
compileJava.options.encoding = 'UTF-8'

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.3'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.3'
}

test {
    useJUnitPlatform()
}

3. VSCode中同步并验证 #

• 打开VSCode的Gradle面板，点击Refresh Gradle Project同步配置
• 右键点击测试类，选择Run Test执行测试
• 若仍有问题，在终端执行Gradle清理构建命令：
  • macOS/Linux: ./gradlew clean build test
  • Windows: gradlew.bat clean build test

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