在控制器initialize()调用Platform.runLater()导致Dialog首次showAndWait()失效

先给你吃个定心丸：你遇到的这个现象完全是可解释的合理行为，不是JavaFX的Bug，核心问题出在控制器initialize()方法的执行时机和**Platform.runLater()的任务调度逻辑**上。

为什么第一次showAndWait()没弹出对话框？ #

我们拆解下你的代码执行时序：

1. 你开始创建对话框，控制台输出Starting dialog creation，此时FXML开始加载，控制器的initialize()方法被调用——注意这个方法是在FX Application Thread上同步执行的。
2. 你在initialize()里调用了Platform.runLater()，这个方法会把传入的Runnable任务放到FX线程的任务队列末尾，要等当前正在执行的所有任务（包括FXML加载、initialize()本身）完成后才会执行。
3. 你第一次调用showAndWait()，但此时对话框的UI状态其实还没完全准备好：FXML刚加载完，但对话框的Stage/Dialog实例可能还没完成布局计算、场景图绑定，甚至可能还没被正确关联到窗口系统。
4. 当runLater()的任务（控制台输出Running Later）执行时，第一次showAndWait()已经结束了——此时对话框的UI虽然完成了初始化，但已经错过了显示的时机，所以你看不到弹窗。
5. 第二次调用showAndWait()时，所有的UI初始化、布局计算都已经完成，对话框的状态完全就绪，所以能正常弹出。

怎么解决这个问题？ #

核心原则是：不要在控制器的initialize()方法里触发showAndWait()，哪怕用了Platform.runLater()。因为initialize()是FXML加载过程中的步骤，此时对话框还处于“半成品”状态。

推荐的正确做法有两种：

1. 外部触发显示：在FXML加载完成、控制器实例化好之后，在创建对话框的代码里直接调用showAndWait()。比如：

// 创建对话框的代码
FXMLLoader loader = new FXMLLoader(getClass().getResource("Dialog.fxml"));
Parent root = loader.load();
DialogController controller = loader.getController();
// 可以在这里给控制器传递参数
Dialog<String> dialog = new Dialog<>();
dialog.getDialogPane().setContent(root);
// 在这里调用showAndWait()，而不是在控制器里
Optional<String> result = dialog.showAndWait();

2. 监听窗口显示事件：如果必须在控制器内处理显示逻辑，应该监听对话框的onShowing或windowShowing事件，此时UI已经完全准备就绪：

public class DialogController implements Initializable {
    @FXML private Button someButton;

    @Override
    public void initialize(URL location, ResourceBundle resources) {
        // 获取对话框的Stage
        Platform.runLater(() -> {
            Stage dialogStage = (Stage) someButton.getScene().getWindow();
            dialogStage.setOnShowing(event -> {
                // 这里可以做初始化准备，但不要调用showAndWait()
                // 如果需要显示其他子对话框，在这里处理是安全的
            });
        });
    }
}

总结 #

你的问题本质是对JavaFX的线程模型和控制器初始化时序理解不到位：FX线程是单线程的，任务按队列顺序执行，而initialize()阶段的对话框还没完全就绪，过早调用showAndWait()会导致显示时机错过。调整代码的执行时机就能解决这个问题。

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