Java Web 中相對路徑與絕對路徑完整指南

核心概念釐清

關鍵區別：Servlet/JSP 中的相對路徑由伺服器端解析（相對於 Web 應用根目錄 /contextPath），而 HTML/JS/Form 中的相對路徑由瀏覽器客戶端解析（相對於網域根目錄 /）。

伺服器端路徑解析規則

1. RequestDispatcher（Forward/Include）

// 正確：以 "/" 開頭表示相對於 Web 應用根目錄
request.getRequestDispatcher("/user/a.jsp").forward(req, resp);

// 錯誤：不以 "/" 開頭會相對於當前 Servlet 路徑，極易出錯
request.getRequestDispatcher("user/a.jsp").forward(req, resp);

2. sendRedirect（重導向）

// 必須包含 contextPath，否則相對於網域根目錄
response.sendRedirect(request.getContextPath() + "/user/a.jsp");

// 或手動硬編碼（不推薦，部署路徑變更即失效）
response.sendRedirect("/myapp/user/a.jsp");

客戶端路徑解析規則

HTML 表單與超連結

<!-- 必須加上 contextPath -->
<form action="<%=request.getContextPath()%>/handleServlet" method="post">
<a href="<%=request.getContextPath()%>/css/style.css">樣式</a>

JavaScript/CSS/圖片引用

<script src="<%=request.getContextPath()%>/js/main.js"></script>
<link rel="stylesheet" href="<%=request.getContextPath()%>/css/main.css">
<img src="<%=request.getContextPath()%>/images/logo.png">

最佳實踐：在 JSP 頁面頂部定義基準路徑變數，全頁複用：

<% String basePath = request.getContextPath(); %>
<base href="<%=request.getScheme()%>://<%=request.getServerName()%>:<%=request.getServerPort()%><%=basePath%>/">

獲取路徑的標準 API 對照表

Java 類中獲取類路徑資源

獨立 Java 應用

// 獲取類所在目錄（含 package 結構）
MyClass.class.getResource("")        // file:/path/to/classes/com/pkg/
MyClass.class.getResource("/")       // file:/path/to/classes/ (classpath 根)

// 獲取資源流（推薦，打包成 JAR 也能用）
MyClass.class.getResourceAsStream("/config.properties")
Thread.currentThread().getContextClassLoader().getResourceAsStream("config.properties")

Web 容器環境差異

避免硬編碼的工程化方案

1. Spring ResourceLoader：resourceLoader.getResource("classpath:config.yml") 統一訪問 classpath、檔案系統、URL 資源。
2. 配置檔外部化：使用 @PropertySource、@ConfigurationProperties 綁定外部配置，啟動時指定 --spring.config.location=file:/etc/app/。
3. 虛擬路徑映射：在 server.xml 或 web.xml 配置 Context docBase，將外部目錄掛載到 Web 應用路徑下。

常見坑點與避雷指南

總結

Java Web 路徑問題的本質是「伺服器端視角」與「客戶端視角」的不一致。掌握核心原則：

1. 伺服器端代碼永遠使用 / 開頭的絕對路徑（相對於 contextPath）
2. 客戶端輸出的 URL 必須包含 ${pageContext.request.contextPath}
3. 資源讀取統一使用 ClassLoader.getResourceAsStream() 走 classpath 機制
4. 外部配置檔透過 Spring 或容器 JNDI 注入，徹底消除路徑硬編碼

遵循這四條鐵律，可徹底杜絕路徑相關的 90% 部署故障與維護陷阱。