JavaFX项目jar包运行提示Runtime组件缺失，已知修复方案无效如何解决

问题根因 #

你触发报错的核心原因是JVM参数顺序错误：--module-path、--add-modules属于JVM启动参数，必须放在-jar参数之前，放在-jar之后的参数会被识别为应用程序的业务入参，JVM不会读取处理，自然无法加载JavaFX运行时组件。

第一步：修正启动命令 #

把你的启动命令调整为如下格式即可：

java --module-path /home/lambevin/Downloads/javafx-sdk-17/lib/ --add-modules javafx.controls,javafx.fxml,javafx.graphics,javafx.media,javafx.swing,javafx.web -jar software-1.0-jar-with-dependencies.jar

最小复现项目的启动命令同理调整参数顺序即可正常运行。

其他可能适配修正（按需调整） #

1. 如果你本地运行的JDK版本为8且是Oracle官方JDK8，本身自带JavaFX组件，不需要额外指定模块参数，直接运行java -jar xxx.jar即可；如果是OpenJDK8，需要单独安装对应版本的OpenJFX。
2. 最小复现项目的编译目标为JDK11，请确保你运行时使用的JDK版本>=11，避免版本不兼容问题。

可选优化（无需每次带参数启动） #

如果不想每次启动都加模块参数，可以选择以下方案打包：

• 改用maven-shade-plugin打包，把JavaFX的所有模块依赖和对应平台的原生组件全部打入fat jar，同时新增一个不继承Application的启动类，在静态main方法中调用Application.launch(你的主类.class, args)绕开JavaFX的启动检查，打包时指定这个新增的类为主类即可直接java -jar启动。
• 使用jlink命令把JDK和JavaFX模块打包为自定义运行时，配合jpackage做成可执行程序，不需要用户本地装Java环境即可运行。

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