IntelliJ生成的JavaFX Kotlin Gradle项目报InvalidModuleDescriptorException

方法一：调整Gradle配置，让模块路径包含Kotlin编译目录 #

Gradle默认只扫描Java编译输出目录，而Kotlin类文件在build/classes/kotlin/main，导致模块描述符找不到对应包。在build.gradle.kts（Groovy版对应build.gradle）中添加以下配置：

Kotlin DSL版本 #

tasks.withType<JavaCompile> {
    options.modulePaths.setFrom(files(tasks.compileKotlin.get().destinationDirectory, options.modulePaths))
}

tasks.withType<Test> {
    jvmArgs = listOf(
        "--module-path", classpath.asPath,
        "--add-modules", "ALL-MODULE-PATH"
    )
}

Groovy版本 #

tasks.withType(JavaCompile) {
    options.modulePaths = files(tasks.compileKotlin.get().destinationDirectory, options.modulePaths)
}

tasks.withType(Test) {
    jvmArgs = [
        "--module-path", classpath.asPath,
        "--add-modules", "ALL-MODULE-PATH"
    ]
}

配置后Gradle会同时扫描Java和Kotlin的编译输出目录，模块描述符就能找到对应包的类文件。

方法二：修正module-info.java的配置 #

确保module-info.java放在src/main/java目录下，内容要匹配你的项目包结构，同时声明Kotlin标准库依赖：

module org.example.baseapp {
    requires javafx.controls;
    requires javafx.fxml;
    requires kotlin.stdlib;

    opens org.example.baseapp to javafx.fxml;
    exports org.example.baseapp;
}

方法三：禁用模块系统并消除警告 #

如果不想使用模块系统，删除module-info.java后，在Gradle配置中添加JVM参数让JavaFX从模块加载：

Kotlin DSL版本 #

dependencies {
    implementation("org.openjfx:javafx-controls:21.0.2")
    implementation("org.openjfx:javafx-fxml:21.0.2")
    implementation(kotlin("stdlib-jdk8"))
}

tasks.withType<JavaExec> {
    jvmArgs = listOf(
        "--add-modules", "javafx.controls,javafx.fxml"
    )
}

这样就能消除Unsupported JavaFX configuration的警告。

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