Windows下GluonFX编译Java程序运行异常 附pom.xml求解决方案

问题根因 #

你遇到的所有报错核心都是GraalVM原生编译阶段的裁剪逻辑移除了未被显式静态引用的类、方法、资源，加上当前pom的版本依赖、编译配置存在疏漏，具体修复步骤如下：

修复步骤 #

1. 调整依赖版本兼容性
   你当前使用的JavaFX 16、GluonFX插件1.0.4、Java 11的组合存在Windows平台原生编译的已知bug，是shader类找不到的直接诱因，先修改pom的properties节点内的版本配置：

• 将maven.compiler.release值改为17
• 将javafx.version值改为17
• 将gluonfx.maven.plugin.version值改为1.0.18及以上
  本地环境同步安装GraalVM CE 17版本，保证编译环境和依赖版本匹配。

2. 补全GluonFX编译配置
   在gluonfx-maven-plugin的<configuration>节点内添加如下配置，指定需要保留的反射类、资源、JNI接口，避免被裁剪：

<reflectionList>
    <list>java.lang.Math</list>
    <list>javafx.scene.shape.Polyline</list>
    <list>com.sun.prism.shader.**</list>
    <!-- 如果你用到了自定义控件、FXML控制器，也要把对应全类名加到这里 -->
</reflectionList>
<resourcesList>
    <list>com/sun/prism/**/*.frag</list>
    <list>com/sun/prism/**/*.vert</list>
    <list>com/sun/javafx/**/*.png</list>
    <!-- 如果你用到了FXML、自定义资源文件，也要把对应路径加到这里 -->
</resourcesList>
<jniList>
    <list>com.sun.glass.ui.win.**</list>
    <list>com.sun.prism.d3d.**</list>
</jniList>

3. 清理冗余配置
   移除com.gluonhq.attach:display依赖下的<classifier>desktop</classifier>和<scope>runtime</scope>配置，GluonFX插件会自动根据目标平台匹配Attach依赖的分类器，手动添加会引发依赖冲突。如果你的项目用到了FXML，还要额外添加javafx-fxml依赖：

<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-fxml</artifactId>
    <version>${javafx.version}</version>
</dependency>

4. 重新编译验证
   修改完成后先执行mvn clean清理历史编译缓存，再执行mvn gluonfx:build gluonfx:nativerun重新编译运行。

二级窗口白屏问题修复 #

该问题是二级窗口用到的控件类、FXML资源被裁剪导致的，把二级窗口对应的FXML路径加到resourcesList，FXML控制器、自定义控件的全类名加到reflectionList即可解决。

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