使用IntelliJ打包JavaFX Jar运行报错：JavaFX运行时组件缺失

我用IntelliJ IDEA给JavaFX程序构建Artifact，但运行生成的Jar文件时一直报错：

Error: JavaFX runtime components are missing, and are required to run this application

相关配置截图如下：

• Artifacts配置：
• Libraries配置：
• Modules配置：
• Project配置：
• 主文件运行配置：

不确定哪里出了问题，求解决办法。

解决办法 #

1. 检查Artifact是否包含JavaFX依赖 #

打开IntelliJ的File -> Project Structure -> Artifacts，确认你的Jar artifact的Output Layout里已添加所有JavaFX相关库（javafx-controls、javafx-fxml等）。如果没有，点击+ -> Library Files，选中对应库添加。

2. 调整主类配置 #

JavaFX程序不能直接用普通主类启动：

• 若你的主类继承javafx.application.Application，直接将Artifact的Main Class设为这个类；
• 若启动报错，可创建一个Launcher类：

public class Launcher {
    public static void main(String[] args) {
        YourJavaFXMainClass.main(args);
    }
}

然后将Artifact的Main Class设为这个Launcher类。

3. 确认模块化配置（模块化项目） #

从Modules截图看项目是模块化的，需确保：

• module-info.java正确声明JavaFX依赖：

module your.module.name {
    requires javafx.controls;
    requires javafx.fxml;
    opens your.package.name to javafx.fxml;
    exports your.package.name;
}

• Artifact打包时包含module-info.class。

4. 运行Jar时手动指定JavaFX运行时 #

若以上步骤无效，运行Jar时可指定JavaFX SDK路径：

java --module-path /本地/javafx/lib路径 --add-modules javafx.controls,javafx.fxml -jar your-app.jar

5. 改用构建工具打包（推荐） #

用Maven或Gradle的JavaFX插件打包更稳定，比如Maven的javafx-maven-plugin：
在pom.xml中添加：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>你的包名.YourJavaFXMainClass</mainClass>
    </configuration>
</plugin>

执行mvn javafx:jar生成可运行Jar，或mvn javafx:jlink生成独立运行包。

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