Maven项目添加JavaFX后运行报错：缺少JavaFX运行时组件

一、先核对pom.xml里的JavaFX依赖配置 #

得确保你的JavaFX依赖是**运行时范围（runtime）**的，还要加上对应操作系统的分类器（classifier）——比如windows、mac、linux，不然Maven可能拉不到对应平台的运行时文件。给个参考配置：

<dependencies>
    <!-- JavaFX核心控件依赖 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>21.0.1</version> <!-- 换成你用的JavaFX版本 -->
        <scope>runtime</scope>
    </dependency>
    <!-- 如果用FXML就加这个 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>21.0.1</version>
        <scope>runtime</scope>
    </dependency>
    <!-- 其他模块比如javafx-graphics、javafx-media按需添加 -->
</dependencies>

要是需要跨平台开发，直接用Maven配置文件自动匹配当前系统：

<profiles>
    <profile>
        <id>windows</id>
        <activation>
            <os>
                <family>windows</family>
            </os>
        </activation>
        <dependencies>
            <dependency>
                <groupId>org.openjfx</groupId>
                <artifactId>javafx-controls</artifactId>
                <version>21.0.1</version>
                <classifier>win</classifier>
                <scope>runtime</scope>
            </dependency>
            <!-- 其他模块也加win分类器 -->
        </dependencies>
    </profile>
    <!-- 照着这个格式添加mac和linux的profile即可 -->
</profiles>

二、把javafx-maven-plugin配置对 #

很多人插件没生效是因为没指定主类或者参数不对。非模块化项目按下面的格式配置，必须明确主类的全路径：

<build>
    <plugins>
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version> <!-- 用最新稳定版即可 -->
            <configuration>
                <mainClass>com.yourpackage.YourMainClass</mainClass> <!-- 替换成你的主类全路径 -->
            </configuration>
            <executions>
                <execution>
                    <!-- 绑定到package阶段，打包时自动处理运行时依赖 -->
                    <phase>package</phase>
                    <goals>
                        <goal>run</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

三、调整IntelliJ的运行配置 #

要是直接点IDE的Run按钮还是报错，手动添加VM参数：

1. 打开Run/Debug Configurations，找到你的运行项
2. 点击Modify options，选择Add VM options
3. 在VM选项里添加以下内容（替换成你本地JavaFX SDK的lib路径）：

   --module-path "D:/javafx-sdk-21.0.1/lib" --add-modules javafx.controls,javafx.fxml
   

   注意：路径要换成你自己下载的JavaFX SDK中lib文件夹的实际位置。

四、用Maven命令运行，别直接点IDE的Run按钮 #

有时候IntelliJ的自动配置没读取Maven的插件设置，直接在终端敲这个命令：

mvn javafx:run

这个命令会自动通过javafx-maven-plugin加载JavaFX运行时组件，大概率能解决报错问题。

五、确认项目是否为模块化项目 #

如果你的项目里有module-info.java，得确保里面声明了JavaFX的依赖：

module com.yourpackage {
    requires javafx.controls;
    requires javafx.fxml;
    opens com.yourpackage to javafx.fxml;
    exports com.yourpackage;
}

要是原项目没有这个文件（非模块化），就别添加，保持原样即可，插件配置里只需要指定mainClass。

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