把常用 JS 抽到一個共用 JSP 裡,然後各頁 include 它——這個思路完全正確,但如果你在共用檔裡寫的是相對路徑,幾乎一定會出問題。這裡還原整個排查過程。
<jsp:include> 是「先編譯被包含檔,再把輸出結果插入」,屬於執行期包含。<%@ include %> 是「先把檔案內容貼進來,再一起編譯」,屬於編譯期包含。就本文討論的路徑問題而言,兩者的行為一致——關鍵都不在 include 本身。
共用 JSP 裡寫的是:
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<script type="text/javascript" src="js/jquery132min.js"></script>
<script type="text/javascript">
$(function(){ alert('hello1'); });
</script>
直接開這個 JSP,一切正常。但在另一個頁面用 <%@ include file="../../common_ext.jsp"%> 引入後,jQuery 就死活載不進來,alert 也不跳。一開始我還懷疑是 script 的載入順序,折騰了一陣子才發現完全不是那回事。
相對路徑 js/jquery132min.js 是相對於「瀏覽器網址列上那個 URL」解析的,不是相對於檔案在專案裡的位置。當共用檔被 include 進 /admin/order/list.jsp,瀏覽器請求的其實是 /admin/order/js/jquery132min.js——這個路徑下根本沒有檔案。
換句話說,共用檔把相對路徑「原封不動」交給了呼叫者,而呼叫者的目錄層級跟共用檔不同,路徑就斷了。專案裡檔案分布在多層目錄時,這個問題必然發生。
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%
String tPath = request.getContextPath();
String tBasePath = request.getScheme() + "://" + request.getServerName()
+ ":" + request.getServerPort() + tPath + "/";
%>
<script type="text/javascript" src="<%=tBasePath%>js/jquery132min.js"></script>
<script type="text/javascript">
$(function(){ alert('hello1'); });
</script>
這樣不管共用檔被誰 include,路徑都從應用程式根目錄算起。更簡潔的寫法是用 JSTL 或 Spring 的標籤:
<script src="${pageContext.request.contextPath}/js/jquery132min.js"></script>
在 <head> 最前面宣告基準路徑,頁面內所有相對連結都改以它為起點:
<base href="<%=tBasePath%>" />
不過 <base> 會連 #anchor 連結一起影響,用之前先確認頁面上沒有依賴錨點的行為。
共用頁面裡一律使用絕對路徑(以 context path 為基準)。這不只是為了避開 include 的問題,也是因為共用檔天生就無法預知自己會被放在多深的目錄被呼叫——它本來就該假設最壞的情況。