Java 與 Web 應用路徑問題終極解析：從相對路徑到 ServletContext 實戰

核心觀念：Java 本質上只認絕對路徑

Java IO 操作底層皆需絕對路徑。所謂「相對路徑」只是 API 幫你根據「當前工作目錄」或「ClassPath」拼湊而成的便利寫法。理解這點，路徑問題就解決一半了。

Web 環境取得 WebRoot 實體路徑

情境一：Servlet、Filter、Listener、Controller 等有 ServletContext 的類別

String webRoot = getServletContext().getRealPath("/");

最標準、最可靠的方式，直接拿到部署後的應用根目錄實體路徑。

情境二：普通類別無法直接取得 ServletContext

方案 1：利用類別載入機制（適用於 Class 在 WEB-INF/classes）

URL url = MyClass.class.getClassLoader().getResource(""); 
// 取得 ClassPath 根目錄 URI，再手動推導 WebRoot

缺點： 若類別被打包進 JAR，此法失效。

方案 2：Spring 風格，啟動時將路徑寫入 System Properties（推薦）

1. web.xml 定義 <context-param> webAppRootKey=webapp.root </context-param>
2. 編寫 ServletContextListener，於 contextInitialized 取得 getRealPath("/") 並 System.setProperty("webapp.root", path)。
3. 全系統任意處呼叫 System.getProperty("webapp.root") 即得路徑。

常用取得 ClassPath/類別路徑的方法對照表

推薦： 使用 Thread.currentThread().getContextClassLoader().getResource("") 取得標準 ClassPath URI，最穩健。

Web 專案常見路徑取得速查

• WebRoot 根目錄： ServletContext.getRealPath("/")（棄用 request.getRealPath("/")）
• src/main/resources 下檔案： new File("com/test.java") 相對 ClassPath 即可（預設即 src 目錄）。
• 專案同級目錄（如 doc/）： 需從 WebRoot 推導：

String path = getServletContext().getRealPath("/");
String base = path.substring(0, path.lastIndexOf("\\WebRoot") + 1);
File propFile = new File(base + "doc/db.properties");

避坑指南

1. 不要硬編碼絕對路徑（跨環境部署會炸）。
2. 區分「ClassPath 資源」（getResourceAsStream）與「檔案系統資源」（File），前者可讀 JAR 內資源，後者不可。
3. 單元測試時 user.dir 指向專案根目錄，與伺服器環境不同，測試代碼需兼容。

掌握這些模式，路徑問題不再是開發阻礙。