在含JTabbedPane的JFrame上层叠加JButton时的渲染异常问题排查

这确实是Mac OS Aqua Look and Feel（Apple官方的Swing实现）下的一个特定平台渲染Bug，不属于跨平台的Swing核心Bug。

问题根源 #

Mac的Aqua L&F在处理JTabbedPane的标签交互（比如鼠标悬停、点击切换标签）时，会触发组件区域的局部重绘，但没有正确通知JLayeredPane中更高层级的组件同步重绘。这就导致视觉上按钮被“覆盖”——实际上组件的层级并没有改变，只是重绘时系统跳过了按钮的绘制步骤；而调整窗口大小会触发全局重绘，所有组件都会被重新渲染，按钮也就重新显示出来了。

可行的解决方案 #

1. 监听Tab切换事件，手动触发重绘

给JTabbedPane添加ChangeListener，在标签状态变化时强制重绘按钮或整个分层面板：

JTabbedPane tabbedPane = new JTabbedPane();
JButton helpButton = new JButton("Help");

// 添加标签切换监听器
tabbedPane.addChangeListener(e -> {
    // 手动触发按钮重绘
    helpButton.repaint();
    // 或者直接重绘整个分层面板
    // frame.getLayeredPane().repaint();
});

2. 使用GlassPane替代JLayeredPane

GlassPane是Swing专门设计用于在所有组件上方显示内容的容器，Mac的Aqua L&F对它的渲染优先级处理更稳定。把按钮放到GlassPane上：

JFrame frame = new JFrame();
JButton helpButton = new JButton("Help");

// 创建透明的GlassPane
JPanel glassPane = new JPanel();
glassPane.setOpaque(false); // 必须设置为透明，否则会遮挡下方组件
glassPane.setLayout(new FlowLayout(FlowLayout.RIGHT)); // 调整按钮位置
glassPane.add(helpButton);

// 设置并显示GlassPane
frame.setGlassPane(glassPane);
glassPane.setVisible(true);

3. 强制指定组件Z-Order（辅助方案）

结合JLayeredPane的层级设置，手动强制按钮的Z-order为最上层，再配合重绘事件：

JLayeredPane layeredPane = frame.getLayeredPane();
// 将按钮添加到最高层级
layeredPane.add(helpButton, JLayeredPane.MODAL_LAYER);
// 强制设置Z-order为最前
layeredPane.setComponentZOrder(helpButton, 0);

总结 #

这个问题是Mac平台特定的Swing渲染疏漏，通过上述方法都可以有效规避。如果你的应用需要跨平台兼容，推荐优先使用GlassPane方案，它的行为在各平台下更一致。

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