Java Web 中相對路徑與絕對路徑徹底解析

核心概念釐清

關鍵區別：服務端解析 vs 客戶端解析。JSP/Servlet 中的 / 由容器解析為 contextPath；HTML/Form/JS 中的 / 由瀏覽器解析為域名根。

服務端常用 API 速查

JSP 隐含對象

// 請求相關
request.getRequestURI()           // /webapp/user/list.jsp
request.getContextPath()          // /webapp
request.getServletPath()          // /user/list.jsp

// 應用相關
application.getRealPath("/")                    // 物理部署根目錄
application.getRealPath(request.getRequestURI()) // 當前請求文件物理路徑
new File(application.getRealPath(request.getRequestURI())).getParent() // 當前文件父目錄

Servlet 中獲取

request.getServletPath();                                  // /user/list.jsp
request.getSession().getServletContext().getRealPath(request.getRequestURI());
servletConfig.getServletContext().getRealPath("/");        // Web 應用物理根目錄

ServletContext 獲取途徑：HttpSession#getServletContext()、PageContext#getServletContext()、ServletConfig#getServletContext()。

客戶端頁面最佳實踐

• 所有靜態資源引用（CSS、JS、圖片、Form action、AJAX URL）統一加前綴：<%= request.getContextPath() %>/resource/path。
• 禁用 ./、../ 等相對於當前文件的路徑，避免文件移動導致 404。
• 表單提交：action="<%=request.getContextPath()%>/servlet/Action"。

Java 類中獲取路徑 (非 Web 環境)

public class PathDemo {
    public static void main(String[] args) {
        System.out.println("user.dir: " + System.getProperty("user.dir"));
        System.out.println("ClassLoader.getSystemResource(\"\"): " + ClassLoader.getSystemResource(""));
        System.out.println("PathDemo.class.getResource(\"\"): " + PathDemo.class.getResource(""));      // 當前包目錄
        System.out.println("PathDemo.class.getResource(\"/\"): " + PathDemo.class.getResource("/"));    // classpath 根
        System.out.println("Thread.contextClassLoader: " + Thread.currentThread().getContextClassLoader().getResource(""));
    }
}

注意：new File("/") 在不同 OS/容器行為不一，嚴禁在生產代碼使用。

主流容器路徑行為差異

資源讀取統一模式 (推薦)

// Spring Resource 抽象 (最通用)
Resource resource = new ClassPathResource("config/app.properties");
InputStream is = resource.getInputStream();

// 原生 ClassLoader (無 Spring 依賴)
InputStream is = MyClass.class.getResourceAsStream("/config/app.properties"); // classpath 根
InputStream is = MyClass.class.getClassLoader().getResourceAsStream("config/app.properties"); // 相同效果

優勢：脫離物理路徑，支援 JAR 內資源、War 包、類路徑掃描，實現真正的「配置與部署分離」。

文件操作常用工具鏈接

• Java File 操作大全：pconline
• Java 文件操作詳解：51CTO
• 目錄/文件增刪改查：Gamvan

總結

1. 區分「服務端路徑」與「客戶端路徑」，request.getContextPath() 是橋樑。
2. 服務端用 ServletContext#getRealPath 獲取物理路徑；客戶端頁面統一加前綴。
3. Java 類讀取資源優先用 ClassLoader#getResourceAsStream，避免硬編碼絕對路徑。
4. 查閱 RFC 2396 (URI 標準) 與 java.io.File、java.net.URI/URL 源碼，建立完整路徑模型。