使用TestFX和JUnit5测试JavaFX UI出现ExceptionInInitializerError

1. 错误根源 #

当前初始化方式存在问题，核心原因如下：

• JavaFX的所有UI控件（包括Label、Scene等）必须在JavaFX平台完成初始化后才能实例化
• 你把App app = new App()定义为测试类的成员变量，成员变量的初始化时机早于TestFX启动JavaFX平台的流程，此时实例化包含UI控件的App类自然会抛出ExceptionInInitializerError
• 额外存在依赖冲突问题：你的Gradle配置同时引入了JUnit4、JUnit5版本的TestFX，以及早已停止维护的org.loadui:testFx依赖，多个版本冲突会导致不可预期的运行错误

2. 修复步骤 #

第一步：清理修正Gradle依赖 #

删除冗余冲突依赖，补充缺失的测试运行依赖，参考配置如下：

plugins {
    id 'org.openjfx.javafxplugin' version '0.0.14' // 建议升级到最新稳定版
}

dependencies {
    // 仅保留JUnit5版本的TestFX依赖
    testImplementation 'org.testfx:testfx-junit5:4.0.16-alpha'
    // JUnit5相关依赖，补充运行引擎
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.2'
}

javafx {
    version = "17"
    modules = [ 'javafx.controls', 'javafx.base', 'javafx.graphics' ] // 补充缺失的graphics模块
}

第二步：修正测试类初始化逻辑 #

将App的实例化移动到TestFX的start()方法内，该方法会在JavaFX平台启动完成后自动调用，此时实例化UI控件不会报错：

public class AppGuiTest extends ApplicationTest {
    private App app; // 仅声明变量，不提前实例化

    @Override
    public void start(Stage stage) throws Exception {
        app = new App(); // JavaFX平台已启动完成，此时实例化正常
        stage.setScene(app.getScene());
        stage.show();
        stage.toFront();
    }

    // 测试用例示例
    @Test
    void testWelcomeLabelExists() {
        // 测试前建议给Label设置id：message.setId("welcomeLabel")
        Label welcomeLabel = lookup("#welcomeLabel").queryAs(Label.class);
        assertEquals("Welcome!", welcomeLabel.getText());
    }
}

3. UI元素测试方法 #

不需要把App对象暴露给测试方法，TestFX提供了完善的UI查询API：

• 给需要测试的UI控件设置唯一的id属性，例如message.setId("welcomeLabel")
• 测试时使用lookup("#控件id")方法定位对应控件，调用queryAs(控件类型.class)即可拿到控件实例进行断言
• 模拟用户操作可以直接使用TestFX提供的clickOn()、write()等内置方法

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