Java Swing耗时Java3D任务场景下WaitDialog不显示问题咨询

安全阿岳

2026-8-31

问题核心原因

所有失效场景本质都是违反Swing单线程模型规则：

Swing的UI渲染、事件处理全靠唯一的事件派发线程（EDT）执行，所有组件的创建、显示、更新、销毁操作必须在EDT上运行
所有耗时操作（文件IO、Java3D计算、网络请求等）绝对不能跑在EDT上，否则会阻塞EDT的事件调度和UI重绘，直接导致窗口不显示、界面无响应

你之前几个版本的错误点非常明确：

初始版本：在EDT上创建WaitDialog后，立刻在同一个线程执行耗时的calculateResult，EDT被计算完全占满，根本没有空闲资源处理WaitDialog的绘制、显示事件，等计算结束你直接关了对话框，自然全程看不到弹窗。
SwingWorker版本：典型的SwingWorker误用——在EDT上调用了阻塞方法worker.get()，这个方法会一直等待后台任务执行完毕才返回，相当于直接把EDT卡死，和第一个版本没有区别，EDT没空渲染WaitDialog。
invokeAndWait版本：逻辑完全写反，把耗时的calculateResult扔到EDT里执行，直接堵死EDT，所以对话框能显示但立刻卡死，计算也无法正常完成调度。
手动Thread版本：一是依然把计算逻辑通过invokeAndWait扔到EDT执行，二是用while(thread.isAlive()) {}空循环占满CPU，EDT根本得不到调度机会，自然无法正常工作。

正确实现方案

首先修正WaitDialog实现，用JDialog而非JFrame做弹窗更符合Swing UI规范，同时把UI操作严格限制在EDT执行：

public class WaitDialog extends JDialog {
    private static final long serialVersionUID = 1L;

    public WaitDialog(Component parent, String message) {
        super(SwingUtilities.getWindowAncestor(parent), Dialog.ModalityType.MODELESS);
        JPanel panel = new JPanel(new GridLayout(2, 1, 12, 12));
        panel.setBorder(new EmptyBorder(12, 12, 12, 12));
        JLabel tipLabel = new JLabel(message, SwingConstants.CENTER);
        panel.add(tipLabel);
        JProgressBar progressBar = new JProgressBar();
        progressBar.setIndeterminate(true);
        panel.add(progressBar);
        setUndecorated(true);
        setAlwaysOnTop(true);
        add(panel);
        pack();
        setLocationRelativeTo(parent);
    }

    public void showDialog() {
        if (SwingUtilities.isEventDispatchThread()) {
            setVisible(true);
        } else {
            SwingUtilities.invokeLater(this::setVisible);
        }
    }

    public void closeDialog() {
        if (SwingUtilities.isEventDispatchThread()) {
            setVisible(false);
            dispose();
        } else {
            SwingUtilities.invokeLater(() -> {
                setVisible(false);
                dispose();
            });
        }
    }
}

然后调整doIt逻辑，核心是不要在EDT上同步等待计算结果，用SwingWorker的回调机制处理任务完成后的逻辑：

// 该方法应在EDT上调用（比如按钮点击事件的回调中）
public void doIt(String fileName) {
    WaitDialog waitDialog = new WaitDialog(null, "正在更新场景，请稍候...");
    waitDialog.showDialog();

    SwingWorker<Result, Void> worker = new SwingWorker<>() {
        @Override
        protected Result doInBackground() throws Exception {
            // 所有耗时IO、计算逻辑全放在后台线程执行，不要操作任何UI组件
            try (InputStream inputStream = new BufferedInputStream(new FileInputStream(fileName))) {
                return ansicht.calculateResult(inputStream);
            }
        }

        @Override
        protected void done() {
            // 任务执行完成后自动在EDT触发，在这里关闭弹窗、处理结果
            waitDialog.closeDialog();
            try {
                Result result = get();
                // 在这里写拿到结果后的后续逻辑：比如更新Java3D场景、刷新界面、提示完成等
                processResult(result);
            } catch (InterruptedException | ExecutionException e) {
                e.printStackTrace();
                JOptionPane.showMessageDialog(null, "场景更新失败：" + e.getMessage(), "错误", JOptionPane.ERROR_MESSAGE);
            }
        }
    };
    worker.execute();
    // 注意：这里绝对不能调用worker.get()，该方法会阻塞当前线程（EDT），直接导致UI卡死
}

// 抽离结果处理逻辑，所有涉及UI更新的操作都在这个方法里执行（EDT上下文）
private void processResult(Result result) {
    // 原有拿到结果后的业务逻辑写在这里
}

关键避坑点

永远不要在EDT上调用SwingWorker.get()、Thread.join()这类会阻塞等待的方法，也不要在EDT上执行任何耗时超过几十毫秒的操作。
后台工作线程绝对不能直接操作Swing组件，所有UI修改必须通过SwingUtilities.invokeLater()提交到EDT执行。
禁止用空循环（比如while(thread.isAlive()){}）等待线程结束，这种写法会占满CPU资源，直接阻塞UI调度。
如果Java3D的场景更新涉及Swing组件交互，最终的UI刷新逻辑也要放到EDT执行，纯计算逻辑可以留在后台线程。

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