最近把某個專案的模組切換改成 Ajax 載入資料,結果遇到一個尷尬狀況:Session 過期之後,Ajax 請求拿不到任何有意義的資料,只回來一段这样的 HTML:
<html> <script type='text/javascript'>window.open('https://192.168.0.118:8080/welcomeAction/loginUI.do','_top'); </script> </html>
這段程式碼本身沒錯,它是給「正常瀏覽器導航」用的。但 Ajax 請求是由 XMLHttpRequest 物件發出的,不是瀏覽器在跳轉,伺服器回傳的內容被 JavaScript 接住了,那段 window.open 也就永遠不會有機會執行。畫面就停在原地,使用者只看到一片空白。
既然伺服器的訊息最終落在 JavaScript 手裡,而 JavaScript 又完全在我們掌控之中,那麼把「跳轉」這件事交給前端來做即可。前提是要能分辨這個請求到底是不是 Ajax——因為兩種請求需要分開處理。
分辨方法很簡單:Ajax 請求的標頭裡會多帶一個 X-Requested-With: XMLHttpRequest。


上面兩張截圖用 Firebug 攔的,第一張是普通 HTTP 請求的標頭,第二張是 Ajax 請求的標頭。差異就在紅框處——Ajax 請求帶有 X-Requested-With,值為 XMLHttpRequest,這就是我們的判斷依據。
用 Struts2 時,權限檢查通常寫在 Interceptor 裡,Session 失效的處理也順理成章放在同一處。
public String intercept(ActionInvocation invocation) throws Exception { ActionContext ac = invocation.getInvocationContext(); HttpServletRequest request = (HttpServletRequest) ac.get(StrutsStatics.HTTP_REQUEST); String requestType = request.getHeader("X-Requested-With"); HttpServletResponse response = (HttpServletResponse) ac.get(StrutsStatics.HTTP_RESPONSE); String path = request.getContextPath(); String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path; //取得 session Map session = ac.getSession(); //若 session 與 user 資訊都存在,則不攔截 if(session != null && session.get(Constants.FE_SESSION_BG_USER) != null && session.get(Constants.FE_SESSION_BG_AUTH) != null){ //權限比對邏輯略,通過則 return invocation.invoke(); }else{ //Session 失效 if(StringUtils.isNotBlank(requestType) && requestType.equalsIgnoreCase("XMLHttpRequest")){ response.setHeader("sessionstatus", "timeout"); response.sendError(518, "session timeout."); return null; }else { String actionName = invocation.getProxy().getActionName(); if (StringUtils.isNotBlank(actionName) && actionName.equals(Constants.FE_BG_LOGINUI)) { return invocation.invoke(); }else if(StringUtils.isNotBlank(actionName) && actionName.equals(Constants.FE_BG_LOGIN)){ return invocation.invoke(); }else{ String login = basePath + "/" + Constants.FE_BG_LOGIN_NAMESPACE + "/" + Constants.FE_BG_LOGINUI + Constants.FE_STRUTS_ACTION_EXTENSION; PrintWriter out = response.getWriter(); out.write("<html><script type='text/javascript'>window.open('"+login+"','_top');</script></html>"); return null; } } } }
關鍵就在 Session 驗證失敗之後的那段判斷:透過 request.getHeader("X-Requested-With") 取值,若不為空且等於 XMLHttpRequest,就判定為 Ajax 請求,於是往回應裡塞一個自訂標頭 sessionstatus: timeout,並以 sendError() 回傳一個自訂的狀態碼(這裡用 518 只是隨便挑一個沒被佔用的號碼)。這些資訊都會被 JavaScript 收到,接下來就換前端接手。
$.ajaxSetup() 設的是全域預設選項,等於一次設定、全站生效,非常適合放進外部 JS 檔共用。
/** * 設定未來(全域)的 AJAX 請求預設選項 * 主要處理 AJAX 請求遇到 Session 過期的情況 */ $.ajaxSetup({ type: 'POST', complete: function(xhr,status) { var sessionStatus = xhr.getResponseHeader('sessionstatus'); if(sessionStatus == 'timeout') { var top = getTopWinow(); var yes = confirm('由於您長時間沒有操作, session 已過期, 請重新登入.'); if (yes) { top.location.href = '/skynk/index.html'; } } } }); /** * 取得最上層視窗物件,避免被 iframe 層層包住時跳錯位置 */ function getTopWinow(){ var p = window; while(p != p.parent){ p = p.parent; } return p; }
第一,complete 而非 success 是這裡的正確選擇——Session 逾時通常伴隨非 2xx 狀態碼,寫在 success 裡永遠不會被觸發。
第二,自訂 HTTP 狀態碼要慎選。雖然規範允許,但中間若有 Proxy、CDN 或前端監控告警服務,遇到不認識的 5xx 可能會觸發不必要的 retry 或誤報。更保守的做法是回 200 加上自訂標頭,或回標準的 401 Unauthorized,語意上也更貼切。