用 Struts2 的 action 轉發到 jsp 之後,頁面上的 css 突然全部失效;但直接在網址列輸入 jsp 路徑開啟,樣式又正常。這個現象幾乎必然指向相對路徑問題。
action 配置:
<action name="listUser" class="listUserAction">
<result>/users/userList.jsp</result>
</action>
(listUser 的作用是查出所有使用者,交由 users 目錄下的 userList.jsp 顯示。此處的 listUserAction 是 applicationContext.xml 中配置的 bean 名稱。)
jsp 中的樣式引用:
<link href="../css/style.css" rel="stylesheet" type="text/css" />
目錄結構是 WebRoot 下有 users 與 css 兩個資料夾,因此 users 裡的 jsp 需要 ../ 回到根目錄再找 css。
問題就在這裡:直接開啟 jsp 時路徑成立,但從 action 跳轉過來時 ../css/style.css 找不到檔案。
<link href="<%=request.getContextPath()%>/css/style.css"
rel="stylesheet" type="text/css" />
絕對路徑確實能解決問題,但把 context path 寫進每個頁面,日後應用程式改名或部署到不同環境時就得全部重寫,移植性大幅下降。
把 result 改成 <result>userList.jsp</result> 並將 jsp 移到根目錄,問題就消失了。這說明關鍵不在 css,而在瀏覽器眼中的當前 URL。
action 預設位於根 namespace,因此轉發後網址列顯示的是類似 /listUser 的路徑。相對路徑 ../css/style.css 是相對於網址列解析的,而不是相對於 jsp 檔案的實體位置。從 /listUser 出發,../ 已經跑到應用程式根目錄之外,自然找不到檔案。
直接開啟 jsp 時網址是 /users/userList.jsp,../ 回到應用程式根目錄,正好命中 css 資料夾——這就是兩者行為不同的原因。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN"
"https://struts.apache.org/dtds/struts-2.1.dtd">
<struts>
<package name="users" extends="struts-default" namespace="/users">
......
<action name="listUser" class="listUserAction">
<result>/users/userList.jsp</result>
</action>
......
</package>
</struts>
重啟伺服器後,網址列會變成 /users/listUser,跳轉後是 /users/userList.jsp。此時 ../css/style.css 的解析結果與直接開啟 jsp 時完全一致,樣式恢復正常。
namespace 對齊只是讓相對路徑「剛好」能運作。更穩健的做法有兩個:
一是使用應用程式根相對路徑。在 jsp 頁面用 JSTL 或 EL 統一加上 context path:
<%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" />
<c:set var="ctx" value="${pageContext.request.contextPath}" />
<link href="${ctx}/css/style.css" rel="stylesheet" type="text/css" />
這樣寫一次,全站頁面都不必再猜自己身在何處,也不受 namespace 調整影響。
二是把靜態資源集中管理。透過後台過濾器或 `
<base href="${pageContext.request.contextPath}/" />
加上這一行後,頁面上所有相對路徑都以此為起點,跳轉方式如何變化都不再影響資源載入。