JavaFX可执行Jar运行报错：缺少运行时组件，求解决方案

问题描述 #

使用Java 17 + Maven构建JavaFX可执行Jar，编译完成后执行以下命令：

java -jar mfe_ttn70_arn_detector_final.jar

出现错误：

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

尝试添加--module-path与--add-modules参数运行仍报错，且希望避免使用这类参数；调整多种Maven插件配置也无效果。
编辑补充：调整参数顺序（用转义反斜杠）后，仍出现两种错误：原错误和java.lang.module.FindException: Module javafx.base not found。

可能的遗漏点及解决方法 #

1. Maven插件未正确嵌入JavaFX依赖 #

需确保使用javafx-maven-plugin并配置正确的打包目标，将JavaFX运行时依赖嵌入产物中，而非仅依赖编译期依赖。

推荐使用jlink生成独立运行镜像（无需额外参数），配置示例：

<plugin>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-maven-plugin</artifactId>
    <version>0.0.8</version>
    <configuration>
        <mainClass>你的主类全限定名（如com.example.ARNDetector）</mainClass>
        <launcher>arn-detector</launcher>
    </configuration>
    <executions>
        <execution>
            <id>default-cli</id>
            <phase>package</phase>
            <goals>
                <goal>jlink</goal>
            </goals>
        </execution>
    </executions>
</plugin>

若需生成可执行Jar，可配合maven-shade-plugin处理模块化依赖，但需注意配置模块合并规则，避免类冲突。

2. module-info.java模块声明错误 #

确保module-info.java正确声明JavaFX模块依赖，示例：

module mfe_ttn70_arn_detector {
    requires javafx.controls;
    // 若使用FXML需添加：requires javafx.fxml;
    opens com.example.detector to javafx.fxml; // 按需开放FXML所在包
    exports com.example.detector; // 导出主类所在包
}

模块名需与pom.xml的artifactId保持一致，避免JVM无法定位模块。

3. MANIFEST.MF配置缺失或错误 #

模块化Jar的MANIFEST.MF需包含模块与主类信息，建议由Maven插件自动生成，不要手动修改。若手动配置，需确保包含：

Main-Class: com.example.detector.MainApp
Module-Name: mfe_ttn70_arn_detector

4. JavaFX依赖范围配置错误 #

检查pom.xml中JavaFX依赖的scope，若设置为provided，Maven不会将依赖打包进Jar，需移除scope或改为compile：

<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-controls</artifactId>
    <version>17.0.8</version>
    <!-- 移除 <scope>provided</scope> -->
</dependency>

5. 命令参数顺序错误 #

若必须使用--module-path参数，需保证参数顺序正确（模块相关参数放在-jar之前），且路径需正确包裹：

java --module-path "D:/javafx-sdk-17.0.8/lib" --add-modules javafx.controls -jar mfe_ttn70_arn_detector_final.jar

路径含空格时必须用引号包裹，否则会拆分路径导致找不到javafx.base等模块。

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