You need to enable JavaScript to run this app. Java GUI进度条搭配CompletableFuture、SwingWorker时直到异步任务结束才更新如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Java GUI进度条搭配CompletableFuture、SwingWorker时直到异步任务结束才更新如何解决

问题原因
  • 违反Swing单线程模型:SwingWorker的doInBackground方法运行在后台工作线程,所有Swing组件的状态修改操作必须在事件调度线程(EDT)中执行,直接在后台线程调用progressBar.setValue()属于非线程安全操作,会导致更新不生效、界面卡顿甚至死锁等异常。
  • 无延迟的死循环占用全部线程资源:现有代码的while循环没有任何休眠逻辑,会持续占满CPU资源,EDT线程得不到调度机会,就算有更新请求也无法及时处理,直到异步任务结束、循环终止后才能一次性处理所有积压的更新请求。
  • 不必要的paintImmediately调用:正常情况下Swing组件的setValue方法会自动触发重绘事件,手动调用paintImmediately反而会打乱Swing的原生重绘调度逻辑,加剧更新异常。
修复方案
  • 用SwingWorker自带的进度通知机制:调用setProgress()方法更新进度,绑定PropertyChangeListener监听进度变化,该监听器的回调自动运行在EDT线程,符合Swing线程规范。
  • 循环中加入合理的休眠间隔:避免循环占满CPU,给EDT留出调度时间,同时也能让进度条的动画更符合人眼观感。
  • 异步任务完成后强制把进度条设为100%,避免进度没跑完任务就结束的显示问题。
修复后代码
JProgressBar progressBar = new JProgressBar();
progressBar.setMinimum(0);
progressBar.setMaximum(100);
progressBar.setValue(0);
progressBar.setStringPainted(true);
CompletableFuture<NetworkToolsTableModel> completableFuture = CompletableFuture.supplyAsync(() -> asyncTask());

SwingWorker<Void, Integer> worker = new SwingWorker<>() {
    @Override
    protected Void doInBackground() throws Exception {
        int val = 0;
        while (!completableFuture.isDone()) {
            if (val < 95) { // 预留5%进度最后补全,避免任务还在运行进度就到100的违和感
                val += 5;
                setProgress(val); // 用SwingWorker内置方法发送进度通知
            }
            // 休眠间隔可根据需求调整,这里以200ms为例
            Thread.sleep(200);
        }
        setProgress(100); // 任务完成后直接拉满进度
        return null;
    }

    @Override
    protected void done() {
        // 如果需要获取asyncTask的返回值,可在该方法中调用completableFuture.get(),该方法运行在EDT线程
    }
};

// 监听进度变化事件,回调自动运行在EDT线程
worker.addPropertyChangeListener(event -> {
    if ("progress".equals(event.getPropertyName())) {
        int progress = (int) event.getNewValue();
        progressBar.setValue(progress);
    }
});

worker.execute();

内容的提问来源于stack exchange,提问作者FiddleBug

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 13:36:06