JavaFX项目打包Jar后缺失Runtime组件问题求助

核心问题原因 #

你的项目是基于JPMS（Java平台模块系统）的模块化项目，JavaFX组件本身也是模块化的。你当前的自定义Jar任务只是将所有依赖打包到一个Jar中，但运行时使用java -jar命令是基于classpath加载，无法识别模块化的JavaFX组件，因此报错。直接运行主类时，IDE自动帮你配置了正确的--module-path，所以能正常运行。

可以将JavaFX Runtime嵌入Jar吗？ #

可以，但需要正确处理模块化依赖的加载逻辑。下面提供两种可行方案：

方案1：构建模块化可执行Jar（需指定模块路径运行） #

修改你的build.gradle中的jar任务，移除手动复制JavaFX SDK的步骤（javafx插件已自动引入依赖），并添加模块路径相关配置：

// 删除原有的copyJavaFXLibs任务

jar {
    manifest {
        attributes(
            'Main-Class': 'com.preventivoapp.appproject_preventivo.QuoteMainApplication',
            // 配置模块类路径，让JVM识别打包的模块
            'Module-Classpath': configurations.runtimeClasspath.files.collect { it.name }.join(' ')
        )
    }
    from {
        configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
    }
    duplicatesStrategy = DuplicatesStrategy.INCLUDE
    // 排除重复的模块信息文件，避免冲突
    exclude 'META-INF/MANIFEST.MF'
    exclude 'module-info.class'
}

构建完成后，运行Jar时需要使用模块路径命令：

java --module-path build/libs/your-jar-name.jar --module com.preventivoapp.appproject_preventivo/com.preventivoapp.appproject_preventivo.QuoteMainApplication

方案2：生成Windows可执行文件（推荐，无需用户配置JavaFX） #

利用jlink生成包含JavaFX Runtime的镜像，再用jpackage打包成双击运行的exe文件，这是JavaFX官方推荐的分发方式。在build.gradle中添加jpackage任务：

// 保留原有插件和配置，添加以下任务
task jpackage(type: Exec) {
    dependsOn jlink
    def imageDir = jlink.outputDir
    def outputDir = file("${buildDir}/jpackage")
    def appName = 'QuoteApp' // 自定义应用名称

    doFirst {
        outputDir.mkdirs()
    }

    commandLine = [
        'jpackage',
        '--type', 'exe',
        '--input', imageDir,
        '--dest', outputDir,
        '--name', appName,
        '--main-module', application.mainModule,
        '--main-class', application.mainClass
        // 可选：添加图标，需替换为你的图标路径
        // '--icon', 'src/main/resources/app-icon.ico'
    ]
}

运行命令生成exe：

./gradlew jpackage

生成的exe文件位于build/jpackage目录下，双击即可运行，无需用户安装Java或JavaFX。

为什么之前的尝试失败？ #

你手动将JavaFX SDK的lib目录加入Jar，这些Jar是模块化文件，直接放入classpath中JVM无法识别为模块，必须通过--module-path加载，因此报错。

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