为何调用BufferedImage.getHeight()报错？img为null的原因及解决

问题场景 #

尝试获取图片中每个像素的RGB值，参考了一段Java代码但运行报错，代码如下：

import java.io.File;
import java.io.FileWriter;
import java.awt.Color;
import java.awt.image.BufferedImage;
import javax.imageio.ImageIO;
public class Art {
   public static void main(String args[])throws Exception {
      FileWriter writer = new FileWriter("pixel_values.txt");
      //Reading the image
      File file = new File("Mountain.jpg");
      BufferedImage img = ImageIO.read(file);
      for (int y = 0; y < img.getHeight(); y++) {
         for (int x = 0; x < img.getWidth(); x++) {
            //Retrieving contents of a pixel
            int pixel = img.getRGB(x,y);
            //Creating a Color object from pixel value
            Color color = new Color(pixel, true);
            //Retrieving the R G B values
            int red = color.getRed();
            int green = color.getGreen();
            int blue = color.getBlue();
            writer.append(red+":");
            writer.append(green+":");
            writer.append(blue+"");
            writer.append("\n");
            writer.flush();
         }
      }
      writer.close();
      System.out.println("RGB values at each pixel are stored in the specified file");
   }
}

运行后抛出异常：

Exception in thread "main" java.lang.NullPointerException: Cannot invoke "java.awt.image.BufferedImage.getHeight()" because "img" is null at Art.main(Art.java:12)

原因分析 #

ImageIO.read(file)返回null的核心原因是程序无法成功加载目标图片，具体分几种情况：

• 文件不存在：程序找不到指定的Mountain.jpg，可能是路径错误、文件名拼写错误（注意Linux/macOS系统大小写严格区分）。
• 图片无效：文件不是ImageIO支持的格式（如JPG、PNG、GIF），或者文件本身损坏、后缀名与实际格式不匹配（比如把文本文件改名为jpg）。
• 权限不足：程序没有读取该文件的权限，导致无法读取图片内容。

解决步骤 #

• 确认文件位置与路径
  • 把Mountain.jpg放到和编译后的.class文件同一目录下；如果图片在其他位置，使用绝对路径，比如File file = new File("C:/Users/xxx/Pictures/Mountain.jpg")。
  • 可以加一行代码打印实际路径，验证程序查找的位置是否正确：

    System.out.println("图片路径：" + file.getAbsolutePath());
    

• 验证图片有效性
  • 手动打开图片，确认能正常显示；如果打不开，说明文件损坏，换一张正常的图片测试。
  • 检查文件后缀名是否正确，比如不要把PNG文件改成JPG后缀。
• 添加空值判断
  • 在读取图片后立即判断是否为null，提前抛出明确错误，避免后续空指针：

    BufferedImage img = ImageIO.read(file);
    if (img == null) {
        System.err.println("错误：无法读取图片，请检查文件路径和有效性");
        return;
    }
    

• 处理权限问题
  • Linux/macOS系统下，执行chmod +r Mountain.jpg赋予文件可读权限；Windows系统检查文件是否被其他程序锁定，或者当前用户有没有读取权限。

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