我之前也碰到过一模一样的状况——IDE里加VM参数能正常运行，导出Jar后双击就弹出JavaFX runtime components are missing, and are required to run this application错误，用Maven打fat jar还收到版本覆盖警告，折腾了好一阵才彻底解决。下面给你一步步拆解解决方案：

核心原因 #

JavaFX从11版本开始不再捆绑在JDK中，且采用了模块化设计。普通的fat jar打包工具（比如maven-assembly-plugin）没法正确处理JavaFX的模块依赖和原生组件（比如Windows的.dll、Mac的.dylib），导致双击运行时JVM找不到必要的JavaFX模块。

推荐解决方案：用JavaFX专属Maven插件打包 #

最可靠的方式是使用javafx-maven-plugin，它专门针对JavaFX的模块化特性设计，能生成可以直接双击启动的自包含运行包，或者正确的可执行Jar。

步骤1：更新pom.xml配置 #

替换掉原来的maven-assembly-plugin，添加以下插件配置：

<build>
    <plugins>
        <!-- 移除或注释原有的maven-assembly-plugin -->
        <!-- <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            ...
        </plugin> -->
        
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <!-- 替换成你module-info.java里的模块名 -->
                <module>your.module.name</module>
                <!-- 替换成你的主类全限定名，比如com.example.MyMainApp -->
                <mainClass>com.example.MyMainApp</mainClass>
            </configuration>
            <executions>
                <!-- 用于本地运行测试 -->
                <execution>
                    <id>default-cli</id>
                    <phase>package</phase>
                    <goals>
                        <goal>run</goal>
                    </goals>
                </execution>
                <!-- 生成自包含运行时镜像（推荐） -->
                <execution>
                    <id>bundle</id>
                    <phase>package</phase>
                    <goals>
                        <goal>jlink</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

步骤2：检查module-info.java的正确性 #

确保你的模块声明包含所有需要的JavaFX依赖，并且主类所在的包正确导出/开放：

module your.module.name {
    // 根据你的应用用到的JavaFX模块添加，比如controls、fxml、web等
    requires javafx.controls;
    requires javafx.fxml;
    
    // 如果用了FXML，需要把控制器所在包开放给javafx.fxml模块
    opens com.example.controllers to javafx.fxml;
    // 导出主类所在的包，让JVM能找到入口
    exports com.example;
}

步骤3：执行打包命令 #

在终端运行：

mvn clean package

打包完成后，你会在target目录下看到一个以模块名命名的文件夹（jlink生成的运行时镜像），进入文件夹的bin目录，双击里面的启动脚本（Windows是.bat，Mac是.sh）就能直接运行，完全不需要用户电脑上安装Java或JavaFX！

如果坚持要生成可双击的Jar #

如果必须用Jar文件，你可以用javafx-maven-plugin的jar目标，或者配合maven-shade-plugin，但需要注意：

1. 创建一个非模块化的启动类（绕开模块路径限制）：

public class AppLauncher {
    public static void main(String[] args) {
        // 调用你的JavaFX主类
        com.example.MyMainApp.main(args);
    }
}

2. 在pom.xml里指定这个启动类作为主类，同时确保所有JavaFX依赖都被打包进Jar。不过这种方式可能在不同系统上出现原生组件缺失的问题，所以还是jlink的方式更稳定。

关于maven-assembly-plugin的版本警告 #

这个警告是因为你指定的插件版本和Maven默认版本冲突，只要明确指定一个兼容的版本（比如3.3.0）就能消除，但既然我们已经用javafx-maven-plugin替代了它，这个警告可以忽略。

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