Java开发Pong游戏背景图片加载失败问题及解决参考

问题概述 #

开发Java版Pong游戏时，背景图片始终无法加载，问题锁定在GamePanel.java的图片加载逻辑中。

排查尝试 #

先后尝试以下操作均未解决问题：

• 重命名背景图片文件
• 更换多张不同的PNG格式图片

错误代码示例 #

// 原错误加载逻辑
private BufferedImage background;

public GamePanel() {
    try {
        // 直接使用File读取，路径依赖运行环境，打包后会失效
        background = ImageIO.read(new File("background.png"));
    } catch (IOException e) {
        e.printStackTrace();
    }
}

修复后可运行代码 #

// 修复后的加载逻辑，使用类加载器读取资源
private BufferedImage background;

public GamePanel() {
    try {
        // 从类路径资源中读取，适配项目开发和打包后的场景
        InputStream imgStream = getClass().getResourceAsStream("/background.png");
        if (imgStream == null) {
            throw new IOException("背景图片资源未找到，请检查resources目录下的文件");
        }
        background = ImageIO.read(imgStream);
        imgStream.close();
    } catch (IOException e) {
        System.err.println("加载背景图片失败：" + e.getMessage());
        e.printStackTrace();
    }
}

项目文件结构 #

确保图片放在resources目录下（Maven/Gradle项目标准结构），结构如下：

• PongGame
  • src/main/java
    • com/yourname/pong
      • GamePanel.java
      • Main.java
  • src/main/resources
    • background.png

效果对比 #

• 修复前：无背景的Pong游戏界面
• 修复后：正常显示背景的Pong游戏界面

目前问题已完全解决，以上代码可直接作为参考使用。

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