JavaEE 獲取路徑全攻略：從 Servlet 到前端的完整路徑解決方案

Java Web 專案路徑獲取完全指南

在 Java Web 開發中，路徑問題始終是困擾開發者的經典難題：getRealPath() 返回 null、部署後找不到配置檔、前端資源 404、絕對/相對路徑混淆。本文系統整理了 Servlet 容器、JSP、前端 JavaScript、各類伺服器的路徑獲取方案，建立統一的路徑認知體系。

核心路徑分類對照表

伺服器端路徑獲取詳細方案

1. Servlet 初始化階段

public void init(ServletConfig config) {
    ServletContext context = config.getServletContext();
    String webRoot = context.getRealPath("/");           // Web 應用根目錄
    String configPath = context.getRealPath("/WEB-INF/config.properties");
    // 注意：某些容器（如 JBoss）可能返回 null，需用替代方案
}

2. 任意 Java 類別中（非 Servlet 環境）

// 方案一：類載入器（推薦）
String classPath = MyClass.class.getClassLoader().getResource("").getPath();
// 方案二：線程上下文類載入器（適配容器環境）
String ctxClassPath = Thread.currentThread().getContextClassLoader().getResource("").getPath();
// 方案三：系統類載入器
String sysClassPath = ClassLoader.getSystemResource("").getPath();

3. JSP 頁面中多種路徑

<%-- 1. 部署後的絕對磁碟路徑 --%>
<%= application.getRealPath("/") %>

<%-- 2. 專案上下文路徑（最常用） --%>
<%= request.getContextPath() %>

<%-- 3. 當前請求完整 URI --%>
<%= request.getRequestURI() %>

<%-- 4. 當前 JSP 檔案絕對路徑 --%>
<%= request.getRealPath(request.getServletPath()) %>

<%-- 5. 伺服器工作目錄（慎用） --%>
<%= new File(".").getAbsolutePath() %>

前端路徑解析：客戶端 vs 伺服器端視角

伺服器端解析（Forward/Redirect）

• RequestDispatcher.forward()：路徑相對於 Web 應用根目錄，以 / 開頭

  request.getRequestDispatcher("/user/profile.jsp").forward(req, resp);

• response.sendRedirect()：路徑相對於 伺服器根目錄，需包含上下文路徑

  response.sendRedirect(request.getContextPath() + "/user/profile.jsp");

客戶端解析（HTML/JS/CSS）

所有瀏覽器端相對路徑基準為 伺服器根目錄 (https://host:port/)，非 Web 應用目錄。

<%-- 錯誤寫法 --%>
<link rel="stylesheet" href="css/style.css">
<form action="submit.do">

<%-- 正確寫法：強制加上下文路徑 --%>
<link rel="stylesheet" href="<%=request.getContextPath()%>/css/style.css">
<form action="<%=request.getContextPath()%>/submit.do">

<%-- JSTL 簡寫 --%>
<c:url value="/css/style.css" var="cssUrl"/>
<link rel="stylesheet" href="${cssUrl}">

各主流容器路徑行為差異

通用專案根目錄獲取工具類

public class PathUtil {
    public static String getWebRootPath() {
        // 1. 嘗試 ServletContext
        String path = WebContextUtils.getServletContext().getRealPath("/");
        if (path != null) return path;
        
        // 2. 回退：類載入器定位 WEB-INF/classes
        URL url = PathUtil.class.getClassLoader().getResource("");
        if (url != null) {
            String filePath = url.getPath();
            int idx = filePath.indexOf("WEB-INF");
            if (idx > 0) return filePath.substring(0, idx);
        }
        
        // 3. 最後手段：user.dir（僅適用 Tomcat 類容器）
        return System.getProperty("user.dir");
    }
}

JavaScript 獲取專案根路徑

function getRootPath() {
    // 當前完整 URL：https://localhost:8080/myapp/page.jsp
    var curWwwPath = window.document.location.href;
    // 路徑部分：/myapp/page.jsp
    var pathName = window.document.location.pathname;
    // 專案名：/myapp
    var projectName = pathName.substring(0, pathName.substr(1).indexOf('/') + 1);
    // 主機地址：https://localhost:8080
    var localhostPath = curWwwPath.substring(0, curWwwPath.indexOf(pathName));
    return localhostPath + projectName; // https://localhost:8080/myapp
}

ClassLoader 深度理解補充

理解雙親委派模型對路徑獲取至關重要：

1. Bootstrap ClassLoader：C++ 實現，載入 rt.jar 核心庫，Java 代碼無法直接訪問
2. Extension ClassLoader：載入 jre/lib/ext 擴展庫
3. Application ClassLoader (AppClassLoader)：載入 classpath 指定路徑，即我們常用的 ClassLoader.getSystemClassLoader()
4. WebApp ClassLoader：容器專用，隔離各 Web 應用，載入 WEB-INF/classes 與 WEB-INF/lib

Thread.currentThread().getContextClassLoader() 通常指向 WebApp ClassLoader，是容器環境下獲取資源的標準入口。

最佳實踐總結

1. 配置檔放在 CLASSPATH：使用 getResourceAsStream() 讀取，避免路徑依賴
2. 上傳檔案存儲：配置外部絕對路徑（如 /data/uploads/），勿存入 Web 應用目錄
3. 前端資源引用：統一使用 ${pageContext.request.contextPath} 或 <c:url>
4. 避免相對路徑：./、../ 在檔案遷移、重構時極易出錯
5. 容器無關性：核心業務代碼不依賴 getRealPath()，提高可移植性

路徑問題本質上是「部署模型」與「開發模型」的不匹配。建立清晰的路徑分類認知，掌握各層級獲取 API，就能從根源上消除這類困擾。