Java 8+Maven+JavaFX 22项目打包及编译问题求助

一、修复Maven编译SwingFXUtils失败问题 #

你遇到的编译失败是因为Maven未引入JavaFX Swing模块的依赖，而Eclipse自动处理了模块依赖导致本地运行正常。按以下步骤解决：

1. 在pom.xml中添加JavaFX Swing模块依赖（版本与你的JavaFX 22匹配）：

<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-swing</artifactId>
    <version>22</version>
</dependency>

2. 配置Maven使用Java 8编译，避免系统Java 20的干扰：
   在pom.xml的build/plugins节点下添加编译插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <release>1.8</release>
        <!-- 替换为你的Java 8 JDK路径 -->
        <executable>/path/to/java8/jdk/bin/javac</executable>
    </configuration>
</plugin>

3. 运行mvn clean install验证编译是否通过。

二、解决"fx runtime components are missing"及MSI打包问题 #

Java 8本身不包含JavaFX，直接运行jar会缺失运行时组件；同时Eclipse生成的普通jar未打包JavaFX依赖，需要用jpackage（系统Java 20自带）或Maven插件将JavaFX运行时与项目一起打包为MSI。

方法1：使用Maven JavaFX插件快速打包 #

在pom.xml中添加javafx-maven-plugin配置：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <!-- 替换为你的主类全限定名 -->
        <mainClass>com.yourcompany.YourMainClass</mainClass>
        <type>msi</type>
        <vendor>你的厂商名称</vendor>
        <appVersion>1.0.0</appVersion>
        <!-- 替换为你的Java 8 JRE路径 -->
        <javaHome>/path/to/java8/jre</javaHome>
        <!-- 添加项目依赖的JavaFX模块 -->
        <modules>
            <module>javafx.controls</module>
            <module>javafx.swing</module>
            <!-- 若用到FXML需添加此模块 -->
            <module>javafx.fxml</module>
        </modules>
    </configuration>
</plugin>

执行以下命令生成MSI：

# 生成包含JavaFX的运行时镜像
mvn javafx:jlink
# 打包为MSI安装包
mvn javafx:jpackage

方法2：手动使用jpackage命令打包 #

1. 确保已下载JavaFX 22 Windows SDK，解压到本地路径
2. 执行以下命令（替换占位符为实际路径/名称）：

jpackage --type msi ^
--input ./target ^
--main-jar your-project.jar ^
--main-class com.yourcompany.YourMainClass ^
--runtime-image /path/to/java8/jre ^
--name YourAppName ^
--vendor "你的厂商名称" ^
--app-version 1.0.0 ^
--win-shortcut ^
--win-menu ^
--module-path "C:/path/to/javafx-22/lib" ^
--add-modules javafx.controls,javafx.swing,javafx.fxml

三、紧急验证步骤 #

1. 完成编译修复后，用Java 8命令测试jar运行：

/path/to/java8/bin/java --module-path "C:/path/to/javafx-22/lib" --add-modules javafx.controls,javafx.swing -jar target/your-project.jar

2. 若运行正常，执行打包命令生成MSI
3. 安装MSI并验证应用功能正常

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