JavaFX项目Jar双击无法打开及Exe失效问题求助

一、解决Jar双击运行问题 #

JavaFX从Java 11起不再是JDK默认内置组件，直接双击或无参数运行Jar会因找不到FX依赖报错，可通过以下两种方式解决：

1. 构建包含JavaFX依赖的可执行Jar（胖Jar） #

在NetBeans中通过构建插件将JavaFX依赖打包进Jar：

• 若使用Maven，添加maven-shade-plugin到pom.xml，配置主类并包含JavaFX模块：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.5.1</version>
      <executions>
          <execution>
              <phase>package</phase>
              <goals>
                  <goal>shade</goal>
              </goals>
              <configuration>
                  <transformers>
                      <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                          <mainClass>你的主类全路径</mainClass>
                      </transformer>
                  </transformers>
                  <artifactSet>
                      <includes>
                          <include>org.openjfx:*</include>
                      </includes>
                  </artifactSet>
              </configuration>
          </execution>
      </executions>
  </plugin>
  

  执行mvn clean package后，生成的shaded Jar可直接双击运行，无需额外参数。

2. 用批处理脚本替代双击 #

若不想打包胖Jar，可编写.bat脚本整合JavaFX启动参数：

@echo off
java --module-path "C:\Users\crist\Documents\jjavafx\javafx-sdk-23.0.1\lib" --add-modules javafx.controls,javafx.fxml,javafx.media -jar HuellaTorniquete.jar
pause

双击该脚本即可直接启动程序。

二、解决Exe无法打开的问题 #

Exe无法运行多因打包时未正确包含JavaFX依赖或运行环境，推荐两种方案：

1. 使用jpackage打包独立Exe（推荐） #

jpackage是JDK自带工具，可生成包含JRE和JavaFX依赖的独立Exe：

1. 确保项目已编译为Jar（或使用上述胖Jar）
2. 打开控制台执行以下命令（替换对应路径与参数）：

jpackage --type exe ^
--input "你的Jar所在目录" ^
--main-jar HuellaTorniquete.jar ^
--main-class 你的主类全路径 ^
--module-path "C:\Users\crist\Documents\jjavafx\javafx-sdk-23.0.1\lib" ^
--add-modules javafx.controls,javafx.fxml,javafx.media ^
--dest "输出目录" ^
--name HuellaTorniquete

生成的Exe自带运行环境，双击即可启动。

2. 检查第三方Exe生成工具配置 #

若使用Launch4j等工具生成Exe，需在配置中添加JavaFX模块参数：

• 在Launch4j的「JRE」选项卡，将--module-path "C:\Users\crist\Documents\jjavafx\javafx-sdk-23.0.1\lib" --add-modules javafx.controls,javafx.fxml,javafx.media填入「VM options」
• 确保指定的JRE路径版本正确，或配置为捆绑JRE

三、NetBeans项目配置检查 #

确认项目JavaFX依赖配置无误：

• 模块化项目：module-info.java需声明依赖模块：

module HuellaTorniquete {
    requires javafx.controls;
    requires javafx.fxml;
    requires javafx.media;
    opens 你的主类所在包 to javafx.fxml;
    exports 你的主类所在包;
}

• 非模块化项目：确保已在NetBeans中添加JavaFX库依赖，且编译、运行阶段均可正常加载。

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