Java Web 異常處理最佳實踐：從堆棧噴屏到友好錯誤頁

開發階段，異常堆棧直接輸出頁面便於調試；但生產環境這極不友好——非技術用戶看到亂碼般的堆棧會恐慌失措。本文提供基於 web.xml 錯誤頁配置的簡潔解決方案，並探討進階交互式錯誤展示思路。

方案一：靜態錯誤頁配置（零代碼侵入）

1. 準備錯誤頁面

<!-- 404.html -->
<body>
  所訪問的資源不存在：對不起，所請求的資源不存在！<br>
</body>

<!-- 500.html -->
<body>
  服務器內部錯誤：對不起，服務器忙！<br>
</body>

2. 配置 web.xml

<web-app version="2.4" xmlns="https://java.sun.com/xml/ns/j2ee" ...>
    <servlet>
        <servlet-name>ErrServlet</servlet-name>
        <servlet-class>lavasoft.errtest.ErrServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>ErrServlet</servlet-name>
        <url-pattern>/servlet/ErrServlet</url-pattern>
    </servlet-mapping>

    <!-- 關鍵：錯誤碼映射 -->
    <error-page>
        <error-code>404</error-code>
        <location>/404.html</location>
    </error-page>
    <error-page>
        <error-code>500</error-code>
        <location>/500.html</location>
    </error-page>
</web-app>

3. 測試 Servlet

public class ErrServlet extends HttpServlet {
    public void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {
        resp.setContentType("text/html");
        throw new RuntimeException("------"); // 強制觸發 500
    }
}

4. 效果驗證

• 訪問不存在路徑 → 容器返回 404 → 自動轉向 404.html
• 訪問 /servlet/ErrServlet → 拋出異常 → 容器返回 500 → 自動轉向 500.html

方案二：進階交互式錯誤頁（推薦）

靜態頁雖簡單但信息單薄。生產環境建議：

1. 錯誤頁顯示友好提示 + 「查看詳情」按鈕
2. 點擊按鈕通過 JS 動態展開堆棧信息（預先隱藏在 <details> 或隱藏 <div> 中）
3. 記錄完整異常到日誌系統（ELK/Logback），錯誤頁顯示錯誤 ID 便於運維追蹤

<!-- 500-advanced.jsp -->
<body>
  <h2>系統暫時不可用，請稍後重試</h2>
  <button onclick="document.getElementById('stack').style.display='block'">查看技術詳情</button>
  <div id="stack" style="display:none; font-family:monospace; white-space:pre-wrap;">
    ${pageContext.exception.stackTrace} <!-- JSTL 輸出堆棧 -->
  </div>
  <p>錯誤參考 ID: ${requestScope['javax.servlet.error.request_uri']}-${System.currentTimeMillis()}</p>
</body>

web.xml 中映射：

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

對比總結

核心建議

1. 永不在生產環境暴露原始堆棧——安全風險 + 用戶體驗雙重損害
2. 區分業務異常與系統異常：業務異常（如「庫存不足」）應友好提示；系統異常記錄日誌並顯示通用錯誤頁
3. 錯誤頁輕量化：避免依賴複雜框架，防止錯誤頁自身報錯導致遞歸
4. 記錄完整上下文：請求參數、用戶信息、會話 ID、錯誤碼，便於事後復盤