Java Swing GUI图片加载异常求助：路径无误仍报文件未找到

问题现象 #

• 在Eclipse中开发Java Swing程序，尝试加载一张16x16、大小1.72KB的PNG图片时，触发File Not Found错误，已确认文件路径无误。
• 更换其他图片加载方法后无报错，但图片始终无法显示。

相关代码 #

import javax.swing.JFrame;
import javax.swing.JLabel;
import java.awt.Color;
import java.awt.image.BufferedImage;
import java.io.File;
import javax.imageio.ImageIO;
import javax.swing.ImageIcon;

public class main {
    public static void main(String[] args) {
        JFrame window = new JFrame("JavaTests");
        window.setVisible(true);
        window.setResizable(true);
        window.setSize(800,600);
        window.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        window.getContentPane().setBackground(Color.PINK);

        try {
            File imageFile = new File("icon.jpg");
            BufferedImage image = ImageIO.read(imageFile);
            JLabel label = new JLabel(new ImageIcon(image));
            label.setSize(image.getWidth(), image.getHeight());
            label.setBackground(Color.BLACK);
            label.setOpaque(false);
            window.add(label);
        } catch (Exception e) {
            System.out.println("LOG: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

关键问题分析 #

1. 文件名后缀不匹配：代码中尝试读取icon.jpg，但实际图片文件是icon.png，这是触发File Not Found错误的直接原因。
2. 窗口显示时机错误：先调用window.setVisible(true)再添加组件，导致组件无法被正确渲染到窗口上。
3. 相对路径可靠性问题：直接使用File读取相对路径，依赖程序运行时的工作目录，在Eclipse环境下可能与预期不符。

解决方案 #

1. 修正文件名后缀 #

将代码中的new File("icon.jpg")修改为new File("icon.png")，确保文件名与实际文件一致。

2. 调整窗口显示顺序 #

将window.setVisible(true)移至所有组件添加完成之后，保证组件能被正确加载并显示：

public static void main(String[] args) {
    JFrame window = new JFrame("JavaTests");
    window.setResizable(true);
    window.setSize(800,600);
    window.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    window.getContentPane().setBackground(Color.PINK);

    try {
        File imageFile = new File("icon.png");
        BufferedImage image = ImageIO.read(imageFile);
        JLabel label = new JLabel(new ImageIcon(image));
        label.setSize(image.getWidth(), image.getHeight());
        label.setBackground(Color.BLACK);
        label.setOpaque(false);
        window.add(label);
    } catch (Exception e) {
        System.out.println("LOG: " + e.getMessage());
        e.printStackTrace();
    }
    // 最后设置窗口可见
    window.setVisible(true);
}

3. 使用类路径加载资源（推荐） #

对于项目内的资源，使用类加载器读取更稳定，避免工作目录的影响：

try {
    // 通过类加载器读取类路径下的图片资源
    BufferedImage image = ImageIO.read(main.class.getResourceAsStream("icon.png"));
    if (image != null) {
        JLabel label = new JLabel(new ImageIcon(image));
        window.add(label);
    } else {
        System.out.println("LOG: 图片资源读取为空");
    }
} catch (Exception e) {
    e.printStackTrace();
}

4. 确认Eclipse资源复制配置 #

右键项目 → 属性 → Java Build Path → Source，确保当前源文件夹的“包含”规则包含*.png，或者直接将图片放在src目录下，Eclipse会自动将非Java文件复制到编译输出目录。

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