JavaFX中如何从其他类动态创建Stage且不触发非FX线程异常

问题原因 #

所有JavaFX UI相关操作（包括Stage/Scene创建、控件属性修改、界面渲染等）都必须在JavaFX专属的应用线程上执行，你当前是在主线程中调用createStage方法直接创建Stage，因此触发线程校验异常。

修复方案 #

1. 基础依赖导入

首先确保导入JavaFX平台工具类：

import javafx.application.Platform;
import java.util.Collections;
import java.util.ArrayList;

2. 修复stages列表初始化问题

你原有代码仅声明了stages未初始化，且多线程操作需要保证线程安全，修改声明为：

// 初始化为线程安全的列表
private static List<Stage> stages = Collections.synchronizedList(new ArrayList<>());

3. 修改createStage方法，将UI操作提交到FX线程执行

如果需要同步获取创建完成的Stage实例，可搭配CompletableFuture实现异步回调：

public static CompletableFuture<Stage> createStage(String data) {
    CompletableFuture<Stage> stageFuture = new CompletableFuture<>();
    // 将UI创建逻辑提交到JavaFX应用线程执行
    Platform.runLater(() -> {
        Stage stage = new Stage();
        Scene scene = new Scene(new Label(data));
        stage.setScene(scene);
        stages.add(stage);
        // 新增Stage直接展示，无需等start方法遍历（start仅在应用启动时执行一次）
        stage.show();
        stageFuture.complete(stage);
    });
    return stageFuture;
}

如果不需要获取返回的Stage实例，可简化为无返回值方法：

public static void createStage(String data) {
    Platform.runLater(() -> {
        Stage stage = new Stage();
        Scene scene = new Scene(new Label(data));
        stage.setScene(scene);
        stages.add(stage);
        stage.show();
    });
}

4. 调用侧代码适配

如果使用带返回值的方法，可通过回调处理创建完成的Stage：

public class MainClass {
    public static void main (String[] args) {
        BasicApp app = BasicApp.getInstance();
        // 异步接收创建完成的Stage
        app.createStage("Test").thenAccept(stage -> {
            // 此处可对Stage做后续自定义操作，已自动运行在FX线程中
            stage.setTitle("自定义标题");
        });
    }
}

如果使用无返回值方法，直接调用即可：

BasicApp.getInstance().createStage("Test");

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