如何让JavaFX工具类等待运行时就绪后加载诊断GUI窗口

问题根因 #

你当前在静态代码块中直接调用Platform.runLater初始化窗口，此时父应用尚未执行launch()方法，JavaFX运行时环境还没有完成启动，因此会抛出IllegalStateException异常。

可选实现方案 #

方案1：无侵入式懒加载（适配Java 9及以上版本） #

该方案不需要父应用做任何额外改造，工具类会自动检测JavaFX运行时状态，未就绪时主动启动运行时：

package owengall.diagnostics;

import javafx.application.Platform;
import javafx.stage.Stage;
import javafx.stage.StageStyle;

class Diagnostics {
    private static Stage gui;
    private static volatile boolean isInitialized = false;

    private static void checkAndInit() {
        if (isInitialized) {
            return;
        }
        synchronized (Diagnostics.class) {
            if (isInitialized) {
                return;
            }
            try {
                // 运行时已就绪直接提交初始化任务
                Platform.runLater(Diagnostics::initGui);
            } catch (IllegalStateException e) {
                // 运行时未就绪，主动启动后再初始化
                Platform.startup(Diagnostics::initGui);
            }
            isInitialized = true;
        }
    }

    private static void initGui() {
        gui = new Stage(StageStyle.UNDECORATED);
        // 后续可补充窗口大小、场景、布局等初始化逻辑
    }

    public static void sayHello() {
        checkAndInit();
        Platform.runLater(() -> {
            // 你的业务逻辑，例如往窗口追加消息
            // addMessageToGui("hello from Diagnostics.sayHello");
        });
    }
}

方案2：主动触发初始化（兼容Java 8版本） #

如果需要兼容Java 8（无Platform.startup方法），可以将初始化逻辑暴露，要求父应用在JavaFX线程启动后主动调用：

工具类修改

package owengall.diagnostics;

import javafx.application.Platform;
import javafx.stage.Stage;
import javafx.stage.StageStyle;

class Diagnostics {
    private static Stage gui;
    private static boolean isInitialized = false;

    /**
     * 初始化方法，必须在JavaFX应用的start方法中调用
     */
    public static void init() {
        if (isInitialized || !Platform.isFxApplicationThread()) {
            return;
        }
        gui = new Stage(StageStyle.UNDECORATED);
        // 后续可补充窗口大小、场景、布局等初始化逻辑
        isInitialized = true;
    }

    public static void sayHello() {
        if (!isInitialized) {
            return;
        }
        Platform.runLater(() -> {
            // 你的业务逻辑，例如往窗口追加消息
            // addMessageToGui("hello from Diagnostics.sayHello");
        });
    }
}

父应用调用示例

package owengall.diagnostics.test;

import javafx.application.Application;
import javafx.stage.Stage;
import owengall.diagnostics.Diagnostics;

class TestDriver extends Application {
    public static void main(String[] args) {
        System.out.println("hello from TestDriver.main");
        launch(args);
    }

    @Override
    public void start(Stage primaryStage) {
        // 启动后第一时间初始化诊断工具
        Diagnostics.init();
        System.out.println("hello from TestDriver.start");
        Diagnostics.sayHello();
        // 父应用自身的窗口逻辑
        primaryStage.show();
    }
}

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