在 SpringMVC 裡用攔截器統一處理登錄校驗是很常見的做法:一旦 session 失效,後台返回一段 JavaScript 讓浏覽器跳轉到登錄頁。這套機制對普通頁面請求有效,但碰上 Ajax 就失靈了。
關鍵在於發起請求的主體不同。普通導航由浏覽器發起,響應中的 script 會被解析執行;而 Ajax 由 JavaScript 中的 XMLHttpRequest 對象發起,響應文本只是被交給 JS 保存下來,不會自動執行。於是「跳轉登錄頁」這段腳本變成一團字符串,用戶看到的是頁面毫無反應,或者數據區域一片空白。
好消息是 Ajax 請求自帶標識。查看請求頭會發現多了一項 X-Requested-With: XMLHttpRequest,後台据此即可分流:
String requestType = request.getHeader("X-Requested-With");
if (requestType != null && "XMLHttpRequest".equalsIgnoreCase(requestType.trim())) {
//如果是ajax請求
response.setHeader("sessionStatus", "timeout");
response.sendError(601, "session timeout.");
return false;
}
這裡選擇用自定義響應頭 sessionStatus 傳遞語義,配合一個約定好的狀態碼,讓前端能精確判斷「這是登錄過期」,而不是去猜 401、403 或某個業務錯誤碼。
jQuery 提供了 ajaxSetup,可以設置全局默認選項,一次配置處處生效:
//設置Ajax請求的全局默認options
jQuery.ajaxSetup({
type: 'post',
complete: function(xhr, ts){
//XMLHttpRequest, textStatus
var sessionStatus = xhr.getResponseHeader('sessionstatus');
if (sessionStatus == 'timeout') {
alert('頁面過期,請重新登錄!');
window.top.location.href = 'Login.htm';
}
}
});
用 complete 而不是 success,是因為超時屬於異常情況,走不到 success 分支。用 window.top 而非 window.location,是為了在 iframe 嵌套場景下讓整個頁面一起跳轉,避免只在子框架裡換頁。
項目裡用了 DataTables 渲染表格,實測發現上述全局配置在它身上不生效。查閱官方說明(https://datatables.net/tn/7 )後確認:DataTables 自己的 ajax 配置會覆蓋全局設置,必須在它的 ajax.error 裡單獨處理:
$('#example').dataTable({
"ajax": {
"url": "findRoles.htm",
"type": "POST",
"error": function(xhr, ts, et) {
//XMLHttpRequest, textStatus, errorThrown
var sessionStatus = xhr.getResponseHeader('sessionstatus');
if (sessionStatus == 'timeout') {
alert('頁面過期,請重新登錄!');
window.top.location.href = 'Login.htm';
}
}
}
});
這提醒我們:凡是自行封裝了 ajax 調用的第三方插件(上傳組件、無限滾動、圖表刷新等),都要確認它是否繞過了全局配置。上線前逐個驗證一次 session 過期場景,比事後排查省事得多。