JavaFX项目启动报错InvalidModuleDescriptorException求助

错误java.lang.module.InvalidModuleDescriptorException: Package com.unknown.fireApp not found in module的核心原因是：模块描述符（module-info.java）中声明了包com.unknown.fireApp，但构建后的Jar包中找不到该包对应的类文件。以下是具体排查和修复步骤：

1. 验证源码目录结构 #

• 确认src/main/java下存在完整的包路径com/unknown/fireApp，且FireApp.java确实位于该目录下。注意包名的大小写（比如fireApp和FireApp的拼写差异），Java对包路径大小写敏感。
• 检查build/classes/java/main/com/unknown/fireApp目录下是否生成了FireApp.class文件：
  • 如果没有，说明编译阶段未将主类纳入编译，大概率是源码目录结构错误。

2. 修正Gradle配置 #

统一Java与JavaFX版本 #

当前使用Java 21，但JavaFX版本为18.0.1，版本不匹配可能引发兼容性问题。修改build.gradle：

sourceCompatibility = '21'
targetCompatibility = '21'

javafx {
    version = '21.0.2' // 与本地javafx-sdk版本一致
    modules = ['javafx.controls', 'javafx.fxml', 'javafx.web', 'javafx.media', 'javafx.base','javafx.swing']
}

确保sourceSets配置正确 #

简化sourceSets配置（避免语法歧义）：

sourceSets {
    main {
        java {
            srcDir 'src/main/java'
        }
        resources {
            srcDir 'src/main/resources'
        }
    }
}

3. 检查module-info.java的位置 #

module-info.java必须放在源码根目录（即src/main/java下直接放置），不能放到com/unknown/fireApp包内。如果位置错误，会导致模块系统无法正确识别包结构。

4. 彻底清理并重新构建 #

执行以下Gradle命令，清理旧构建产物、刷新依赖并重新编译：

./gradlew clean build --refresh-dependencies

5. 统一VM参数与依赖版本 #

VM参数中指定的javafx-sdk-21.0.2需与build.gradle中配置的JavaFX版本一致，避免版本冲突。

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