如何用GraalVM Native Image将已有JavaFX Jar打包为原生应用？

概述 #

我有一个混合纯Java与B4J的JavaFX应用，已通过JDK 19编译为Jar包，希望打包成原生可执行文件。GraalVM Native Image是选定方案，CLI版本打包成功，但JavaFX版本使用native-image时始终找不到JavaFX模块，构建失败。

当前操作环境为Windows，目标是生成Windows和Linux平台的可执行文件，使用GraalVM 22.3.1。

运行与打包命令 #

正常运行JavaFX应用的命令 #

java --module-path "%JAVA_HOME%\javafx\lib" --add-modules=javafx.controls,javafx.graphics,javafx.swing,javafx.web,javafx.fxml,javafx.swt --add-opens=javafx.controls/com.sun.javafx.scene.control.inputmap=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens=javafx.controls/com.sun.javafx.scene.control.behavior=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.scene.traversal=ALL-UNNAMED --add-opens=javafx.graphics/javafx.scene=ALL-UNNAMED --add-opens=javafx.base/com.sun.javafx.collections=ALL-UNNAMED --add-opens=javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED --add-opens=javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.css=ALL-UNNAMED --add-opens=javafx.base/com.sun.javafx.runtime=ALL-UNNAMED --add-opens=javafx.controls/com.sun.javafx.scene.control.skin=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.geom=ALL-UNNAMED --add-opens=javafx.graphics/javafx.scene.canvas=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.geom.transform=ALL-UNNAMED -jar MyApp.jar

适配后的Native Image打包命令 #

native-image --verbose --module-path "%MODULE_PATH%" --add-modules=javafx.controls,javafx.graphics,javafx.swing,javafx.web,javafx.fxml,javafx.swt --add-opens=javafx.controls/com.sun.javafx.scene.control.inputmap=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.scene=ALL-UNNAMED --add-opens=javafx.controls/com.sun.javafx.scene.control.behavior=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.scene.traversal=ALL-UNNAMED --add-opens=javafx.graphics/javafx.scene=ALL-UNNAMED --add-opens=javafx.base/com.sun.javafx.collections=ALL-UNNAMED --add-opens=javafx.controls/com.sun.javafx.scene.control=ALL-UNNAMED --add-opens=javafx.base/com.sun.javafx.event=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.css=ALL-UNNAMED --add-opens=javafx.base/com.sun.javafx.runtime=ALL-UNNAMED --add-opens=javafx.controls/com.sun.javafx.scene.control.skin=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.geom=ALL-UNNAMED --add-opens=javafx.graphics/javafx.scene.canvas=ALL-UNNAMED --add-opens=javafx.graphics/com.sun.javafx.geom.transform=ALL-UNNAMED -jar MyApp.jar

尝试过的操作与报错 #

1. 两种MODULE_PATH配置：
   • 设置为%JAVA_HOME%\javafx\lib
   • 设置为该目录下所有Jar包的完整路径逗号分隔列表
2. 报错信息：

Error occurred during initialization of boot layer
java.lang.module.FindException: Module javafx.swt not found
Error: Image build request failed with exit status 1
com.oracle.svm.driver.NativeImage$NativeImageError: Image build request failed with exit status 1
        at org.graalvm.nativeimage.driver/com.oracle.svm.driver.NativeImage.showError(NativeImage.java:1730)
        at org.graalvm.nativeimage.driver/com.oracle.svm.driver.NativeImage.build(NativeImage.java:1427)
        at org.graalvm.nativeimage.driver/com.oracle.svm.driver.NativeImage.performBuild(NativeImage.java:1387)
        at org.graalvm.nativeimage.driver/com.oracle.svm.driver.NativeImage.main(NativeImage.java:1374)

3. 移除javafx.swt模块后，依然报错找不到其他JavaFX模块，说明Native Image完全无法识别JavaFX模块路径。

已考虑的方案疑问 #

• Gluon的GraalVM方案：自带JDK 17，不符合我需要的JDK 19，且看起来更适合新项目而非已有Jar包。
• MANIFEST.MF添加模块路径：仅支持Class-Path，不确定能否解决问题。

解决方案 #

1. 匹配JavaFX与JDK、GraalVM版本 #

GraalVM Native Image对JavaFX模块兼容性要求严格，必须确保使用的JavaFX SDK版本与JDK 19、GraalVM 22.3.1完全适配。下载对应JDK版本的JavaFX SDK，且保证Jar包包含module-info.class（模块化版本）。

2. 修正Native Image模块路径参数 #

• 不要用逗号分隔单个Jar路径，直接传入JavaFX的lib目录即可，Native Image会自动识别目录内的模块化Jar
• 确认%JAVA_HOME%\javafx\lib下的所有Jar都是JDK 19对应的版本，且存在module-info.class

3. 移除不必要的模块 #

如果应用未使用SWT交互功能，直接从--add-modules中删除javafx.swt，避免无意义的模块查找错误。

4. 切换为类路径模式打包 #

如果应用是非模块化的，可尝试用--class-path替代--module-path，同时指定主类：

native-image --verbose --class-path "%JAVA_HOME%\javafx\lib\*;MyApp.jar" --add-opens=javafx.controls/com.sun.javafx.scene.control.inputmap=ALL-UNNAMED ... [其他add-opens参数] -H:Class=com.your.app.MainClass

替换com.your.app.MainClass为应用的主类全限定名。

5. 添加GraalVM元数据配置 #

JavaFX部分类需要反射支持才能打包，手动创建reflect-config.json配置文件，例如：

[
  {
    "name": "javafx.scene.control.Button",
    "allDeclaredConstructors": true,
    "allPublicConstructors": true,
    "allDeclaredMethods": true,
    "allPublicMethods": true
  }
]

打包时加入参数：-H:ReflectionConfigurationFiles=reflect-config.json，也可添加--enable-all-security-services启用JavaFX所需的安全服务。

6. 跨平台打包建议 #

直接在Windows打包Linux可执行文件兼容性较差，建议在Linux环境（WSL或虚拟机）安装相同版本的GraalVM和JavaFX SDK，直接在目标平台打包。

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