Java11环境下AWT自定义Label子类paint、update方法未调用问题

按优先级排查根因： #

• 方法重写签名错误（最高发）

  AWT Label的paint、update方法固定签名为：
  public void paint(Graphics g)
public void update(Graphics g)
  若你编写代码时未添加@Override注解，极易出现参数类型导入错误（比如引入了非java.awt.Graphics的其他图形类）、方法名拼写错误、修饰符不符合要求的问题，此时你定义的是全新方法而非父类方法的重写，自然不会被AWT渲染框架调用。
  修复方式：给两个方法都添加@Override注解，IDE会自动提示签名错误，修正为正确格式即可。

• 重量级组件绘制逻辑不兼容

  java.awt.Label属于重量级组件，默认绘制逻辑由操作系统本地对等体（Peer）控制，本地绘制逻辑会优先执行，覆盖你自定义的绘制代码。
  修复方案：

  1. 优先改用轻量级Swing组件实现：继承javax.swing.JLabel而非AWT原生Label，Swing组件的绘制完全由JVM管控，重写paintComponent方法即可稳定实现自定义绘制。如果仅需要蓝色边框，无需自定义子类，直接调用setBorder(BorderFactory.createLineBorder(Color.BLUE))即可实现需求，代码更简洁。
  2. 若必须使用AWT Label，需在重写的paint方法开头先调用super.paint(g)完成基础文本渲染，再执行你的边框绘制逻辑。
• Java 11渲染优化导致绘制跳过

  Java 11默认开启AWT硬件加速渲染管线，部分平台下会跳过重量级组件的自定义绘制逻辑。
  修复方式：启动应用时添加对应JVM参数关闭硬件加速：

  • Windows平台：-Dsun.java2d.d3d=false
  • macOS/Linux平台：-Dsun.java2d.opengl=false
• 容器布局未触发重绘

  批量添加TableLabel实例到容器后，需要调用容器的validate()方法触发布局计算，再调用repaint()方法触发全量重绘，否则组件可能处于未初始化状态不会触发绘制方法。

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