ImageIO.read() 讀取圖片路徑問題排查

常見錯誤原因

ImageIO.read() 拋出 IIOException 或返回 null，通常因：

1. 路徑不存在或非文件：相對路徑基於 工作目錄（IDE 運行時通常為專案根目錄），非代碼所在目錄。
2. 文件非圖片格式或損壞：無對應 ImageReader 插件。
3. 權限不足：無讀取權限。

排查步驟

File file = new File(path);
System.out.println("絕對路徑: " + file.getAbsolutePath());
System.out.println("存在: " + file.exists());
System.out.println("是文件: " + file.isFile());
System.out.println("可讀: " + file.canRead());
System.out.println("長度: " + file.length());

若 exists() 為 false，檢查路徑拼接邏輯；若為 true 但 read() 失敗，嘗試 ImageIO.read(new FileInputStream(file)) 排除文件鎖定問題。

最佳實踐

• 使用 ClassLoader.getResourceAsStream() 讀取 classpath 下資源（打包後也生效）。
• 外部配置文件路徑，通過配置注入，避免硬編碼。
• 捕獲 IOException 並記錄詳細路徑信息，便於生產環境定位。