Spring Boot+Maven的JavaFX应用IDE可运行但命令行执行失败求助

问题分析 #

项目在Eclipse中添加指定VM参数可正常运行，但执行mvn spring-boot:run时触发JavaFX runtime components are missing错误，核心原因有两点：

1. Maven运行时未传递JavaFX所需的模块路径与模块参数；
2. pom.xml中JavaFX依赖版本混乱（11、13、14混合），与本地使用的JavaFX SDK 19.0.2.1版本不匹配，引发兼容性问题。

解决方案 #

步骤1：统一JavaFX依赖版本 #

将pom.xml中所有JavaFX相关依赖的版本统一为19.0.2.1，并添加对应系统的classifier（Windows填win，macOS填mac，Linux填linux），确保依赖与本地SDK版本一致：

<properties>
    <java.version>17</java.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <javafx.version>19.0.2.1</javafx.version>
</properties>

<!-- 替换原有的JavaFX依赖 -->
<dependencies>
    <!-- 其他原有依赖保持不变 -->
    
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-swing</artifactId>
        <version>${javafx.version}</version>
        <classifier>win</classifier>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>${javafx.version}</version>
        <classifier>win</classifier>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-web</artifactId>
        <version>${javafx.version}</version>
        <classifier>win</classifier>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-base</artifactId>
        <version>${javafx.version}</version>
        <classifier>win</classifier>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>${javafx.version}</version>
        <classifier>win</classifier>
    </dependency>
</dependencies>

步骤2：配置Spring Boot Maven插件传递JVM参数 #

在pom.xml的<build><plugins>节点中添加spring-boot-maven-plugin，并配置jvmArguments参数，将Eclipse中使用的VM参数传入：

<build>
    <plugins>
        <!-- 保留原有的maven-resources-plugin -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>3.0.4</version> <!-- 与spring-boot-starter-parent版本保持一致 -->
            <configuration>
                <jvmArguments>
                    --module-path C:\Users\piratack007\Desktop\javafx-sdk-19.0.2.1\lib --add-modules=javafx.controls,javafx.fxml
                </jvmArguments>
            </configuration>
        </plugin>
    </plugins>
</build>

可选：命令行直接传递参数（无需修改pom） #

若不想修改pom.xml，可直接在运行命令时附加JVM参数：

mvn spring-boot:run -Dspring-boot.run.jvmArguments="--module-path C:\Users\piratack007\Desktop\javafx-sdk-19.0.2.1\lib --add-modules=javafx.controls,javafx.fxml"

注意事项 #

• 确保JavaFX SDK路径正确，若路径包含空格，Windows系统需用引号包裹路径；
• 如需跨平台运行，可结合maven-javafx-plugin处理不同系统的依赖，单平台运行上述配置即可满足需求。

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