使用Gluon编译JavaFX为Android APK时Menu、ComboBox控件无法找到

DevOps 小满

2026-10-14

问题根因

该问题由GraalVM静态可达性分析的类裁剪机制导致，既不是Gluon不支持标准JavaFX控件，也不是你的依赖配置有误：

Gluon打包Android APK底层依赖GraalVM将Java代码编译为原生镜像，编译阶段会自动裁剪所有未被检测到静态引用的类
你通过FXML动态加载的ComboBox、Menu控件，不会被静态分析识别到引用关系，因此被误裁出最终的APK安装包，运行时就会抛出java.lang.ClassNotFoundException异常
桌面端运行是JIT模式，不会做类裁剪，因此运行正常

解决方法

你可以二选一任意一种方案解决：

方案1：在Gluon插件配置中显式声明保留类

在pom.xml的gluonfx-maven-plugin配置节点下，新增<reflectionList>配置，把所有FXML中用到、但未在Java代码中直接实例化的控件类列进去即可：

<plugin>
    <groupId>com.gluonhq</groupId>
    <artifactId>gluonfx-maven-plugin</artifactId>
    <version>你的插件版本号</version>
    <configuration>
        <!-- 其他原有配置 -->
        <reflectionList>
            <list>javafx.scene.control.ComboBox</list>
            <list>javafx.scene.control.Menu</list>
            <!-- 后续新增的FXML动态加载控件都要在此补充 -->
        </reflectionList>
    </configuration>
</plugin>

方案2：在Java代码中添加静态引用

你也可以直接在项目的启动类中加一段静态代码块，显式引用需要保留的控件类，GraalVM分析到静态引用后就不会裁剪这些类：

public class MyAppLauncher extends Application {
    static {
        // 显式标记FXML用到的控件类，避免被GraalVM裁剪
        Class<?>[] dummyRefs = {
            javafx.scene.control.ComboBox.class,
            javafx.scene.control.Menu.class
        };
    }

    // 原有启动逻辑不变
    @Override
    public void start(Stage stage) throws Exception {
        // ...
    }
}