IntelliJ插件项目中FXMLLoader无法识别JavaFX类但手动创建正常问题求助

你遇到的问题本质是类加载器不匹配导致的：

• 你直接用代码new HBox()创建JavaFX元素时，使用的是你当前类的类加载器，该加载器可以正常识别你在Gradle中引入的JavaFX依赖，所以运行正常。
• FXMLLoader默认使用系统类加载器/线程上下文类加载器解析FXML文件中引用的类，而IntelliJ插件的运行环境类加载器结构特殊，默认的类加载器没有权限访问你插件依赖的JavaFX类，因此无法识别FXML中声明的HBox等JavaFX类型，抛出对应异常。

修复步骤 #

1. 手动指定FXMLLoader的类加载器 #

不要使用FXMLLoader的静态load方法，改为实例化对象后手动传入你当前类的类加载器，代码修改为：

FXMLLoader fxmlLoader = new FXMLLoader(getClass().getResource("/HeatMapScene.fxml"));
// 手动指定当前类的类加载器，保证能识别JavaFX类和你插件内的自定义类
fxmlLoader.setClassLoader(getClass().getClassLoader());
Parent playRoot = fxmlLoader.load();

2. 补全runIde的JVM启动参数 #

Java 11及以上版本的模块化机制会限制反射访问权限，FXML加载需要依赖反射操作JavaFX类，需要在build.gradle的runIde配置中补全JVM参数：

runIde {
    jvmArgs = [
            '--add-exports',
            'java.base/jdk.internal.vm=ALL-UNNAMED',
            // 新增以下参数
            '--add-modules', 'javafx.controls,javafx.fxml',
            '--add-opens', 'javafx.graphics/javafx.scene=ALL-UNNAMED',
            '--add-opens', 'javafx.controls/javafx.scene.layout=ALL-UNNAMED',
            '--add-opens', 'javafx.fxml/javafx.fxml=ALL-UNNAMED',
            // 如果后续你添加了自定义的FXML控制器，需要额外开放控制器所在包给javafx.fxml模块，示例：
            // '--add-opens', '你的根包名/控制器所在包路径=javafx.fxml'
    ]
}

3. 可选：更新FXML的命名空间版本 #

你当前FXML中声明的JavaFX版本是8，和你依赖的JavaFX 11版本不匹配，可以修改为对应版本避免潜在兼容问题：

<HBox id="hboxHeatMapSceneRoot" maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity"
      prefHeight="400.0" prefWidth="600.0" xmlns="http://javafx.com/javafx/11" xmlns:fx="http://javafx.com/fxml/1">

修改完成后执行./gradlew clean build重新构建项目，再启动插件测试即可。

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