如何部署嵌入JavaFX的Java Swing可执行Jar包

问题根源 #

Eclipse运行时会自动加载JavaFX相关库，但普通Jar打包不会包含这些依赖，导致运行时找不到JavaFX类——双击Jar无报错是因为没显示控制台输出，实际是抛出了类找不到的异常。

修复步骤 #

1. 确认JavaFX SDK配置 #

• 先确保项目Build Path中已添加JavaFX SDK的必要模块，比如javafx.swing（JFXPanel依赖）、javafx.web（如果用到WebView）、javafx.base等，根据SimpleSwingBrowser的功能选择。

2. 模块化打包（推荐，适配JDK11+） #

JavaFX从JDK11开始为模块化设计，用这种方式打包最稳定：

• 在项目根目录创建module-info.java，示例内容：

  module SimpleSwingBrowser {
      requires javafx.swing;
      requires javafx.web; // 若用到WebView则添加
      requires java.desktop;
      exports com.yourpackage; // 替换为主类所在的包名
  }
  

• 用jlink生成包含依赖的自定义运行时：

  jlink --module-path "你的JavaFX SDK路径/lib;项目编译后的模块路径" --add-modules SimpleSwingBrowser --output runtime-image
  

• 再用jpackage生成桌面应用包（可直接双击运行）：

  jpackage --name SimpleSwingBrowser --module-path "你的JavaFX SDK路径/lib;项目编译后的模块路径" --module SimpleSwingBrowser/com.yourpackage.MainClass --type app-image
  

3. 非模块化Fat Jar打包（适配老版本JDK） #

如果不想用模块化，可将JavaFX依赖打包进Jar：

• Eclipse手动打包：
  1. 选择Export -> Runnable JAR File，勾选Package required libraries into generated JAR。
  2. 若出现签名冲突（JavaFX的Jar自带签名），需先解压JavaFX的Jar包，删除META-INF下的*.SF、*.DSA、*.RSA签名文件，再重新打包进Fat Jar。
• 构建工具自动处理：
  • Maven用maven-shade-plugin，配置排除签名文件：

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>3.4.1</version>
        <executions>
            <execution>
                <phase>package</phase>
                <goals><goal>shade</goal></goals>
                <configuration>
                    <filters>
                        <filter>
                            <artifact>*:*</artifact>
                            <excludes>
                                <exclude>META-INF/*.SF</exclude>
                                <exclude>META-INF/*.DSA</exclude>
                                <exclude>META-INF/*.RSA</exclude>
                            </excludes>
                        </filter>
                    </filters>
                    <transformers>
                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <mainClass>com.yourpackage.MainClass</mainClass>
                        </transformer>
                    </transformers>
                </configuration>
            </execution>
        </executions>
    </plugin>
    

  • Gradle用shadowJar插件：

    plugins {
        id 'java'
        id 'com.github.johnrengelman.shadow' version '7.1.2'
    }
    
    shadowJar {
        exclude 'META-INF/*.SF', 'META-INF/*.DSA', 'META-INF/*.RSA'
        manifest {
            attributes 'Main-Class': 'com.yourpackage.MainClass'
        }
    }
    

4. 临时运行方案 #

若不想打包依赖，可在命令行运行Jar时手动指定JavaFX路径：

java --module-path "你的JavaFX SDK路径/lib" --add-modules javafx.swing,javafx.web -jar 你的Jar文件名.jar

排查技巧 #

不要双击Jar运行，打开命令行执行Jar命令，能看到具体的错误信息（比如ClassNotFoundException），方便定位问题。

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