Java使用ClassLoader加载不同包下图片报NullPointerException如何解决

问题根因 #

NullPointerException的核心原因是ClassLoader.getSystemResource(path)返回了null，你传入的路径不符合ClassLoader的资源加载规则：

• ClassLoader加载资源的根路径是编译后class文件的输出根目录（普通Java项目的bin目录、Maven项目的target/classes目录），不是项目源码的src目录
• ClassLoader.getSystemResource()不识别路径开头的斜杠，也不识别源码层级的src前缀
• 如果你把图片放在src的java源码目录下，大部分IDE默认不会把非.java后缀的文件复制到编译输出目录，自然加载不到

解决方案 #

1. 调整资源存放位置

• Maven/Gradle项目：把图片放到src/main/resources/diff/images/目录下，构建工具会自动把resources下的所有文件复制到classpath根目录
• 普通Java项目：在IDEA中右键存放图片的目录，选择「Mark Directory as -> Resources Root」，确保非java文件被复制到编译输出目录

2. 修正路径写法
   去掉路径中的src前缀和开头的斜杠，直接写classpath根目录下的相对路径：
   String path = "diff/images/image2.png";

3. 增加空校验避免崩溃
   可以在加载前先判断资源是否存在，方便定位问题：

URL imgUrl = ClassLoader.getSystemResource(path);
if (imgUrl == null) {
    System.out.println("资源加载失败，请检查路径：" + path);
    // 可在此处加载默认占位图
} else {
    image = new JLabel(new ImageIcon(imgUrl));
}

修正后完整示例 #

class AA extends JPanel{
    String path = "diff/images/image2.png";
    JLabel image = null; 

    public AA() {
        setLayout(null);
        setBounds(0,0,200,400);
        setBackground(Color.black);
        
        URL imgUrl = ClassLoader.getSystemResource(path);
        if (imgUrl != null) {
            image = new JLabel(new ImageIcon(imgUrl));
            image.setBounds(0,0,200,400);
            add(image);
        } else {
            System.err.println("图片资源未找到，请检查路径配置");
        }
    }
}

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