萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 錯誤頁面配置全解析:page 指令 errorPage 與 isErrorPage 實戰

兩種配置方式

方式一:頁面級指定(推薦用於單頁異常處理)

業務頁:`business.jsp`

<%@ page errorPage="errorPage.jsp" %>
<%
// 業務代碼拋出異常
throw new RuntimeException("業務邏輯異常測試");
%>

錯誤頁:`errorPage.jsp`

<%@ page isErrorPage="true" contentType="text/html;charset=UTF-8" %>
<html><body>
<h2>系統發生錯誤</h2>
<p>異常信息:<%= exception.getMessage() %></p>
<p>堆棧跟蹤:</p>
<pre><%
    exception.printStackTrace(new java.io.PrintWriter(out));
%></pre>
</body></html>

關鍵點:錯誤頁必須設置 `isErrorPage="true"`,容器才會注入 `exception` 隱含對象。

方式二:web.xml 全局映射(推薦用於統一異常處理)

<error-page>
  <exception-type>java.lang.Exception</exception-type>
  <location>/error.jsp</location>
</error-page>
<error-page>
  <error-code>404</error-code>
  <location>/404.jsp</location>
</error-page>
<error-page>
  <error-code>500</error-code>
  /500.jsp

優先匹配具體異常類型,再匹配錯誤碼。生產環境建議**全局映射為主,頁面級為輔**。

錯誤頁最佳實踐

  1. 不暴露堆棧給用戶:生產環境只顯示友好提示,堆棧記錄到日誌系統(ELK/Sentry)。
  2. 保持響應碼:錯誤頁默認返回 200,需手動設置:`response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);`
  3. 避免二次異常:錯誤頁代碼極簡,不調用複雜邏輯、不依賴可能失效的 Bean。
  4. 區分 AJAX 請求:檢測 `X-Requested-With: XMLHttpRequest`,返回 JSON 錯誤而非 HTML。

常見誤區

  • 以為 `errorPage` 只能指向 JSP,**也可以指向 Servlet/HTML**。
  • 在錯誤頁中使用 `<%@ include file="header.jsp" %>` 靜態包含時,若 header 也拋異常會導致遞歸,改用動態包含或獨立錯誤佈局。
  • 忽略 `isErrorPage="true"` 導致 `exception` 為 null。
copyright © 萬盛學電腦網 all rights reserved