J2SE 資源路徑問題解析與最佳實務

問題背景

在 Java 應用程式中讀取資源檔（圖片、配置檔等）時，開發環境與打包後的 JAR 執行環境路徑不同，常導致資源找不到。

錯誤示範：使用絕對路徑

Image image = Toolkit.getDefaultToolkit().getImage("C:/project/res/a.gif"); // 僅開發機有效

正確做法：使用 Class.getResource()

public void init() {
    // 相對於當前類的包路徑載入資源
    Image image = Toolkit.getDefaultToolkit().getImage(getClass().getResource("a.gif"));
    ImageIcon icon = new ImageIcon(image);
    bt.setIcon(icon);
    
    String className = this.getClass().getName();
    System.out.println(className);
    
    this.add(bt);
    this.setSize(300, 300);
    setVisible(true);
    this.addWindowListener(new WindowAdapter() {
        @Override
        public void windowClosing(WindowEvent e) {
            super.windowClosing(e);
            System.exit(0);
        }
    });
}

關鍵要點

• getClass().getResource("a.gif") 以類所在包為基準尋找資源，打包進 JAR 後仍能正確定位。
• 若資源置於專案根目錄（非包內），可用 getClass().getResource("/a.gif")（以類路徑根為基準）。
• ClassLoader.getSystemResource() 同樣以類路徑根為基準，不需前綴 /。
• 建議將資源檔置於 src/main/resources（Maven 標準目錄），編譯自動複製至 target/classes，打包進 JAR 根目錄。

常見陷阱

1. 大小寫敏感：Linux/Unix 系統下檔名大小寫必須完全一致。
2. 資源未打包：確認建置工具（Maven/Gradle/Ant）已將資源納入輸出。
3. 多類載入器環境：Web 容器、OSGi 等環境下需注意類載入器層級，必要時使用 Thread.currentThread().getContextClassLoader()。

最佳實務總結

• 統一使用 Class.getResource() 或 ClassLoader.getResource() 載入資源。
• 資源檔放置於標準資源目錄，隨專案打包。
• 避免硬編碼檔案系統路徑。
• 單元測試驗證資源載入邏輯，確保開發與生產環境一致。