Java Swing更新JLabel的Icon后组件层级错乱置顶问题求助

问题根因 #

• 首先代码存在变量定义错误：你在Game类中重复定义了同名变量backgroundLabel，分别对应JPanel和JLabel类型，会导致运行时变量指向异常，首先要修正这个命名问题。
• 其次Swing顶层容器默认没有固定的层级管理规则，组件更新内容触发重绘时，默认会将最近更新的组件优先渲染到顶层，就会出现背景层盖住上层文本、按钮的问题。

解决方案 #

快速修复方案（无需调整现有组件结构） #

每次更新背景图之后，手动将背景面板固定到容器的最底层即可，在每次调用Game.backgroundLabel.setIcon()的代码后追加两行代码：

// 将背景面板的层级设为最底层，z-order数值越小层级越低
Game.con.setComponentZOrder(Game.backgroundPanel, 0);
// 触发容器整体重绘
Game.con.repaint();

规范实现方案（用JLayeredPane管理层级，永久规避层级错乱） #

你之前使用JLayeredPane报错，大概率是没有手动设置组件的坐标尺寸，JLayeredPane默认没有布局管理器，所有组件必须显式指定bounds才会正常显示，完整用法如下：

1. 初始化时用JLayeredPane作为层级管理容器：

// Game类初始化阶段
JLayeredPane layeredPane = new JLayeredPane();
layeredPane.setBounds(0, 0, 800, 600);
con.add(layeredPane);

2. 按层级从低到高添加所有组件：

// 背景层放到最底层，JLayeredPane.DEFAULT_LAYER对应常量值-30000，专门用于放置背景
backgroundPanel.setBounds(0, 0, 800, 600);
layeredPane.add(backgroundPanel, JLayeredPane.DEFAULT_LAYER);

// 文本框、按钮等交互组件放到更高的层级，数值越大层级越高
layeredPane.add(Game.mainTextArea, JLayeredPane.PALETTE_LAYER);
layeredPane.add(Game.choice1, JLayeredPane.PALETTE_LAYER);
layeredPane.add(Game.choice2, JLayeredPane.PALETTE_LAYER);
layeredPane.add(Game.choice3, JLayeredPane.PALETTE_LAYER);

后续不管怎么更新背景图的内容，都不会出现层级错乱的问题。

额外注意事项 #

• 所有使用的图片资源建议改成相对路径，不要写本地绝对路径，避免程序打包发布后找不到资源。
• 背景面板可以取消设置opaque（不透明）属性，降低不必要的重绘开销。

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