IntelliJ IDEA中JavaFX程序启动失败：缺失运行时组件怎么解决？

架构老林

2026-7-6

解决JavaFX Runtime Components Missing报错的步骤

以下是针对该问题的具体排查和解决方法：

校验VM选项格式
确保--module-path后的路径是JavaFX SDK的lib目录绝对路径，路径包含空格时必须用双引号包裹；--add-modules要包含项目用到的所有JavaFX模块，基础项目至少要写javafx.controls,javafx.fxml（若使用FXML）。示例正确格式：
```
--module-path "D:\javafx-sdk-21\lib" --add-modules javafx.controls,javafx.fxml
```
注意不要漏写模块或出现路径拼写错误。
匹配JDK与JavaFX版本
JavaFX版本必须和项目使用的JDK版本兼容：比如JavaFX 11+需要JDK 11及以上，JavaFX 21建议搭配JDK 21。版本不匹配会导致配置无效。
确认启动类配置
在Run Configuration里，检查Main class是否选择了继承Application的JavaFX启动类，避免误选其他类作为启动入口。
检查Project Structure中的库配置
进入File > Project Structure > Libraries，确认添加的JavaFX库指向SDK的lib目录，且该库已关联到当前项目模块（在Modules > Dependencies中可见JavaFX库被标记为Compile或Runtime）。
模块化项目额外检查
若项目是模块化（存在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;
}
```
模块名要与--add-modules中的内容对应，同时opens和exports语句要根据FXML所在包正确配置。
清理并重新构建项目
执行Build > Clean Project，再执行Build > Rebuild Project，最后重新运行，避免缓存导致的配置不生效问题。