Java Swing中paintComponent渲染JPanel图像无显示问题求助

核心问题根因 #

• 资源加载逻辑完全错误，配合空异常捕获块，导致图像永远加载失败却没有任何提示
• 绘制流程中存在多处不符合Swing规范的写法，进一步放大了显示异常的概率

逐点排查修正 #

1. 补全异常捕获逻辑，消灭“静默失败”
   原代码的catch块为空捕获，所有IO加载失败的异常都被直接吞掉，没有任何控制台输出，是你排查不到问题的核心原因。必须在catch块中补充异常打印逻辑，比如加上e.printStackTrace()，同时要校验资源加载结果，避免后续方法拿到null值无提示执行。
2. 修正类路径资源的加载方式
   原代码使用new File(filePath)读取带类路径前缀/resources/tile.png的资源，实际是从操作系统磁盘根目录定位文件，完全不是从项目类路径（编译后的资源输出目录）加载内容。
   项目源码目录下的resources文件夹，在编译时会将其下所有文件直接拷贝到类路径根目录，根本不会保留resources这层文件夹结构，因此：
   • 不能用文件系统API读取，需要通过类加载器的getResource()方法定位类路径下的资源
   • 资源路径要匹配编译后的目录结构：如果tile.png直接放在resources目录下，正确的加载路径是"/tile.png"，而非"/resources/tile.png"
3. 优化图像加载时机
   原代码在paintComponent方法中每次触发重绘时都重新加载图像，不仅性能损耗极大，还容易因为资源加载的偶发失败导致绘制结果异常。正确做法是在面板初始化阶段（比如构造函数中）一次性加载图像，将BufferedImage存为成员变量供绘制时调用。
4. 补全paintComponent的基础流程
   重写paintComponent时必须在方法第一行调用super.paintComponent(g)，保证Swing组件的基础绘制状态被正确重置，避免出现绘制上下文残留、组件闪烁、内容不刷新的问题。

修正后的参考实现 #

// 存为成员变量，初始化时加载一次的图像对象
private BufferedImage tileImg;

public CustomGamePanel() {
    // 面板初始化时完成资源加载
    tileImg = loadImage("/tile.png");
}

/**
 * 修正后的类路径资源加载方法
 */
public BufferedImage loadImage(String classpathPath) {
    BufferedImage img = null;
    try {
        // 从类路径定位资源
        var resourceUrl = getClass().getResource(classpathPath);
        if (resourceUrl == null) {
            System.err.println("资源不存在：" + classpathPath);
            return null;
        }
        img = ImageIO.read(resourceUrl);
    } catch (IOException e) {
        // 打印异常，不做静默捕获
        e.printStackTrace();
    }
    return img;
}

@Override
protected void paintComponent(Graphics g) {
    // 先执行父类的基础绘制逻辑
    super.paintComponent(g);
    // 非空校验后再绘制图像
    if (tileImg != null) {
        g.drawImage(tileImg, 0, 0, this);
    }
}

补充说明：Graphics.drawImage()方法接收到null的图像对象时，不会抛出任何运行时异常，只会直接跳过绘制流程，这也是为什么程序运行无报错、无图像的直接表现。

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