NetBeans 讀取圖片失敗：IIOException "Can't read input file" 排查全流程

異常信息

Exception in thread "main" javax.imageio.IIOException: Can't read input file!
    at javax.imageio.ImageIO.read(ImageIO.java:1301)
    at swing.Demo1.main(Demo1.java:22)

核心原因

`ImageIO.read(File)` 或 `read(InputStream)` **找不到文件或流為空**。常見誤區：

• 相對路徑基於**運行時工作目錄**，而非源碼目錄。
• NetBeans 項目運行時工作目錄通常是項目根目錄，圖片放在 `src/` 下編譯不會自動複製到 `build/classes/`。
• 打包成 JAR 後，文件變為類路徑資源，必須用 `getResourceAsStream()` 讀取。

三種正確讀取姿勢

1. 開發階段：使用絕對路徑 (僅調試)

File imgFile = new File("D:/projects/MyProject/images/bg.png"); // 絕對路徑
BufferedImage img = ImageIO.read(imgFile);

2. 開發階段：相對路徑 + 複製資源到構建目錄

1. 在項目屬性 `Build` → `Copying Files` 添加 `**/*.png`、`**/*.jpg` 等模式。
2. 代碼使用相對構建類目錄的路徑：
   File imgFile = new File("images/bg.png"); // 相對 build/classes/

3. 生產/打包階段：類路徑資源流讀取 (標準做法)

// 圖片放在 src/resources/images/bg.png (Maven) 或 src/images/bg.png (普通項目)
// 編譯後自動進入 build/classes/images/bg.png 或 JAR 根目錄/images/bg.png

InputStream is = getClass().getResourceAsStream("/images/bg.png"); // 斜槓開頭 = 類路徑根
if (is == null) {
    throw new IllegalStateException("資源未找到: /images/bg.png");
}
BufferedImage img = ImageIO.read(is);

NetBeans 具體配置步驟

1. 右鍵項目 → `Properties` → `Sources` → `Encoding` 確保 UTF-8。
2. `Build` → `Packaging` → 勾選 `Copy Resources` (或 `Copying Files` 添加模式)。
3. 將圖片文件放在 `src/main/resources/` (Maven) 或 `src/` 下對應包結構中。
4. 代碼統一用 `getClass().getResourceAsStream("/path/to/img.png")`。

調試技巧

// 打印類路徑資源真實 URL 確認路徑
URL url = getClass().getResource("/images/bg.png");
System.out.println("資源 URL: " + url); 
// null 表示未找到；file:/... 或 jar:file:/...!/... 表示找到

// 列出 JAR 內所有資源驗證打包
try (JarFile jar = new JarFile("dist/MyApp.jar")) {
    jar.stream().filter(e -> e.getName().endsWith(".png"))
       .forEach(e -> System.out.println(e.getName()));
}

常見坑總結表