Gradle 8创建JavaExec自定义任务报错：无法确定唯一主类

问题原因 #

你的任务classpath中包含两个带有main函数的类：com.analytic.AnalyticApplicationKt和com.analytic.training.TrainingAppKt，即便你在JavaExec任务中指定了mainClass，若classpath配置不明确，Gradle仍会触发自动主类检测逻辑，导致冲突报错。

解决方案 #

方案1：完善自定义JavaExec任务配置（推荐） #

确保每个自定义JavaExec任务明确指定classpath和mainClass，避免Gradle使用默认路径扫描多余主类：

修改后的代码示例：

tasks {
    val prepareDataset by creating(JavaExec::class) {
        dependsOn("build")

        // 明确指定要执行的主类
        mainClass.set("com.analytic.training.TrainingAppKt")
        // 传递运行参数
        args("--arg1=value1", "--arg2=value2")
        // 绑定到main源码集的运行时classpath，限定扫描范围
        classpath = java.sourceSets["main"].runtimeClasspath

        description = "Prepares the training dataset"
        group = "training"
    }
}

task<JavaExec>("prepareDataset2") {
    dependsOn("build")

    mainClass.set("com.analytic.training.TrainingAppKt")
    args("--arg1=value1", "--arg2=value2")
    classpath = java.sourceSets["main"].runtimeClasspath

    description = "Prepares the training dataset"
    group = "training"
}

方案2：全局指定默认主类（适合项目多主类场景） #

在build.gradle.kts中添加Java插件的全局主类配置，覆盖自动检测逻辑：

java {
    mainClass.set("com.analytic.training.TrainingAppKt")
}

注意：此配置会影响Gradle默认的run任务，若仅需自定义JavaExec任务生效，优先使用方案1。

方案3：移除多余主类（代码层面调整） #

如果com.analytic.AnalyticApplicationKt并非项目必需的主类，可以直接删除该类的main函数，或重构代码避免多个顶层主函数存在。

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