Java 獲取資源路徑全攻略：CLASSPATH 內外、Web 環境、最佳實踐

專案中讀取配置檔、模板、圖片等資源時，路徑處理錯誤是高頻 Bug 來源。本文系統整理 ClassLoader、Class、ServletContext 等多種獲取路徑的方式，並給出避坑指南。

核心 API 對比表

關鍵區別：相對路徑 vs 絕對路徑

• Class.getResource("name") → 相對於**當前類包**解析（不以 / 開頭）。
• Class.getResource("/name") → 相對於**classpath 根**解析（以 / 開頭）。
• ClassLoader.getResource("name") → **永遠相對於 classpath 根**，不接受 / 開頭。

獲取 CLASSPATH 外資源（如專案根目錄配置檔）

// 假設類位於 /home/popeye/testjava/build/classes/net/...
URL base = ThisClass.class.getResource(""); // 獲取類所在目錄
File configFile = new File(base.getFile(), "../../../config/app.properties");
String absolutePath = configFile.getCanonicalPath(); // /home/popeye/testjava/config/app.properties

Web 環境最佳實踐

@WebServlet("/init")
public class InitServlet extends HttpServlet {
    @Override
    public void init() {
        String webRoot = getServletContext().getRealPath("/"); // 部署根目錄
        File config = new File(webRoot, "WEB-INF/config/app.properties");
        // 後續讀取 config...
    }
}

鐵律：路徑處理十大避坑指南

1. ❌ 禁止 System.getProperty("user.dir") —— 工作目錄隨啟動方式變化，極不穩定。
2. ✅ 優先使用 URI/URL 形式，轉 File 時用 toURI() 避免空格編碼問題。
3. ✅ 資源放入 src/main/resources（Maven 標準），以 classpath:xxx 統一引用。
4. ❌ 禁止硬編碼絕對路徑（D:/data/...），專案無法移植。
5. ✅ 若必須指定外部路徑，請用配置檔（YAML/Properties）+ 環境變數注入。
6. ✅ 單元測試與主程式共用 ClassLoader.getResource，確保測試環境一致。
7. ⚠️ ANT/IDE 啟動時 getResource("") 行為可能不同，以 java -cp 命令列驗證為準。
8. ✅ 打包成 Fat Jar 時，資源在 Jar 內無法用 File 讀取，必須用 getResourceAsStream。
9. ✅ 統一封裝 ResourceLoader 工具類，集中管理路徑解析邏輯。
10. ✅ 文檔化專案資源目錄結構，新人於入職即可查閱。