Java Swing/AWT GUI组件重复显示异常问题求助

核心问题根源 #

你遇到的组件重复显示、调整窗口恢复、点击按钮后异常，本质是两个Swing开发常见问题：

1. EDT线程违规：Swing组件的创建、更新必须在事件调度线程（EDT）中执行，计时器启动后如果在后台线程直接修改组件，会打乱渲染逻辑。
2. 重绘/布局未触发：组件状态变化后没主动通知系统更新渲染缓存，调整窗口时系统自动触发重绘，所以临时恢复正常。

具体修复步骤 #

1. 强制所有GUI操作在EDT中执行 #

• 应用启动时，用SwingUtilities.invokeLater()包裹窗口初始化：

public static void main(String[] args) {
    SwingUtilities.invokeLater(() -> {
        MainFrame frame = new MainFrame();
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.pack();
        frame.setVisible(true);
    });
}

• 若使用java.util.Timer，计时器任务里所有修改组件的操作必须切到EDT：

java.util.Timer timer = new java.util.Timer();
timer.scheduleAtFixedRate(new TimerTask() {
    @Override
    public void run() {
        // 执行时间计算等非GUI操作
        String currentTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("HH:mm:ss"));
        // 切换到EDT更新组件
        SwingUtilities.invokeLater(() -> {
            timeDisplayLabel.setText(currentTime);
        });
    }
}, 0, 1000);

2. 改用Swing专用Timer #

Swing自带的javax.swing.Timer默认在EDT中触发事件，无需手动线程切换，从根源避免问题：

javax.swing.Timer swingTimer = new javax.swing.Timer(1000, e -> {
    // 直接在这里更新GUI，无需额外线程处理
    timeDisplayLabel.setText(LocalDateTime.now().format(DateTimeFormatter.ofPattern("HH:mm:ss")));
});
swingTimer.start();

3. 修复重绘与布局问题 #

• 组件状态变化（修改文本、显示/隐藏等）后，主动调用revalidate()和repaint()：

// 组件内容或布局修改后执行
timePanel.revalidate();
timePanel.repaint();

• 避免用setBounds()手动定位组件，改用标准布局管理器（如BorderLayout、GridBagLayout），手动布局易导致组件重叠渲染。

4. 排查重复添加组件的代码 #

检查按钮点击事件中是否存在重复调用add(component)的逻辑，重复添加组件会导致同一组件被多次渲染，出现重复显示的情况。

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