Java Swing自定义JPanel绘制背景后内部组件不显示问题求助

根因分析 #

导致子组件无法显示的核心原因是绘制逻辑中断：

• Swing的JComponent绘制流程按顺序分为三步：paintComponent（绘制自身内容）→ paintBorder（绘制边框）→ paintChildren（绘制子组件），三个步骤共享同一个从方法参数传入的Graphics上下文实例。
• 你在paintComponent方法末尾手动调用了g2.dispose()，直接销毁了公共的绘制上下文，导致后续边框、子组件的绘制流程完全无法执行。
• 同时存在两个非致命问题：
  • getShape()方法使用getBounds()获取坐标，该值是相对于父容器的坐标，在自身绘制逻辑中使用会出现偏移，应该使用组件自身的宽高计算相对坐标
  • 调用super.paintComponent(g)已经完成了背景填充，后续手动填充背景属于冗余操作

修复步骤 #

1. 直接删除paintComponent方法的最后一行g2.dispose()：永远不要手动销毁从方法参数传入的Graphics实例，只有你自己通过Graphics.create()手动创建的Graphics副本才需要手动回收。
2. （可选优化）删除两行重复绘制背景的冗余代码：

g2.setPaint(getBackground());
g2.fill(getShape());

3. 修正getShape()方法的坐标逻辑，避免绘制偏移：

private Shape getShape() {
    return new Rectangle(0, 0, getWidth(), getHeight());
}

可选优化建议 #

main方法中直接操作Swing组件、使用Thread.sleep阻塞主线程不符合Swing线程规范，建议将Swing初始化逻辑放到SwingUtilities.invokeLater()中执行，动画状态切换可以用Swing Timer实现，避免阻塞EDT线程。

修改完成后重新运行代码，即可看到斜纹背景和子组件都能正常渲染。

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