如何解决JavaFX项目打包可双击Jar后运行提示缺失FX环境组件问题？

问题原因 #

你导出的Jar仅包含自身代码与非JavaFX依赖，未打包JavaFX模块，而普通用户的JRE默认不附带JavaFX环境，导致运行时无法找到必需的JavaFX组件。

方案1：使用Maven javafx:jlink创建独立运行包（推荐给普通用户） #

jlink会生成包含自定义JRE（内置JavaFX）+应用程序的独立目录，用户无需额外安装JRE或JavaFX，直接双击启动脚本即可运行。

1. 完善pom.xml中的javafx-maven-plugin配置：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <!-- 替换为你的主类全路径，例如com.example.MyApp -->
        <mainClass>你的主类全路径</mainClass>
        <!-- 根据应用用到的JavaFX模块调整，比如用到fxml就加javafx.fxml -->
        <modules>
            <module>javafx.controls</module>
            <module>javafx.fxml</module>
        </modules>
    </configuration>
</plugin>

2. 执行Maven命令：

mvn clean install javafx:jlink

3. 打包完成后，target目录下会生成image文件夹：
   • Windows用户双击image\bin\你的应用名.exe启动
   • Linux/macOS用户运行image/bin/你的应用名脚本
     将整个image文件夹打包发给用户即可。

方案2：创建包含JavaFX依赖的可执行Jar（适合已有Java环境的用户） #

通过maven-assembly-plugin将JavaFX依赖打包进应用Jar，需注意处理JavaFX的本地原生库。

1. 在pom.xml中添加插件配置：

<!-- 先配置JavaFX插件 -->
<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>你的主类全路径</mainClass>
        <modules>
            <module>javafx.controls</module>
            <module>javafx.fxml</module>
        </modules>
    </configuration>
</plugin>

<!-- 配置assembly插件打包fat jar -->
<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
        <archive>
            <manifest>
                <mainClass>你的主类全路径</mainClass>
                <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
            </manifest>
            <manifestEntries>
                <Module-Path>lib/</Module-Path>
            </manifestEntries>
        </archive>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

2. 执行打包命令：

mvn clean assembly:single

3. 后续操作：
   • 将target目录下的xxx-jar-with-dependencies.jar取出
   • 从你的JavaFX SDK的lib目录中，复制对应操作系统的原生库文件到Jar同目录的lib文件夹
   • 用户运行命令：java -jar xxx-jar-with-dependencies.jar

额外注意事项 #

• 若为模块化项目（存在module-info.java），需声明依赖：

module com.example.myapp {
    requires javafx.controls;
    requires javafx.fxml;
    requires mysql.connector.java;
    requires net.sf.barcode4j;
    opens com.example.myapp to javafx.fxml;
    exports com.example.myapp;
}

• 若为非模块化项目（无module-info.java），需在javafx-maven-plugin中添加参数：

<configuration>
    <mainClass>你的主类全路径</mainClass>
    <options>
        <option>--add-modules</option>
        <option>javafx.controls,javafx.fxml</option>
    </options>
</configuration>

内容的提问来源于stack exchange，提问作者Mohamed El Amin BOUCHAREB