IDEA运行正常的JavaFX项目cmd运行jar报组件缺失如何解决

IDEA运行项目时会自动将项目引入的JavaFX依赖加入运行时类路径，因此开发阶段启动无异常。JavaFX从JDK 11开始已从标准JDK中剥离为独立组件，普通方式打包的jar包不会内置JavaFX运行时，直接在cmd中执行java -jar命令启动时，JVM无法找到JavaFX相关组件就会抛出该错误。

根据你的使用场景选对应方案即可：

方案1：临时运行（无需修改打包配置） #

运行jar时手动指定JavaFX模块路径和需要加载的模块，命令格式如下：

java --module-path "本地JavaFX SDK的lib目录绝对路径" --add-modules javafx.controls,javafx.fxml,javafx.graphics -jar 你的项目jar包文件名.jar

• 如果项目用到了javafx.web、javafx.media、javafx.swing等其他JavaFX模块，直接把模块名追加到--add-modules参数后，用逗号分隔即可。

方案2：打包为可独立运行的Fat Jar（推荐日常使用） #

把所有依赖（含JavaFX组件）全部打入同一个jar包，后续运行不需要依赖本地JavaFX SDK：

1. 新建一个普通启动类，不要继承JavaFX的Application类，作为jar包的程序入口：

   public class AppLauncher {
       public static void main(String[] args) {
           // 替换为你原本写的JavaFX主类（继承Application的类）
           YourMainApp.main(args);
       }
   }
   

2. 用Maven/Gradle的打包插件（比如Maven的maven-shade-plugin、Gradle的shadow插件）配置打包规则，将主类指定为上面新建的AppLauncher，打包完成后直接执行java -jar 生成的jar包名.jar即可正常启动。

   注意：如果直接把继承Application的JavaFX主类设为jar包入口，哪怕依赖都打全了，依然会抛出JavaFX组件缺失的错误，这是Java 11+版本模块化机制导致的已知问题。

方案3：打包为平台原生可执行程序（适合分发） #

用JDK自带的jlink或者jpackage工具，把JDK运行时、JavaFX组件、项目代码一起打包成对应操作系统的原生程序（Windows下为exe文件、macOS下为app文件、Linux下为可执行二进制文件），用户不需要提前安装JDK和JavaFX，双击即可运行。

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