Catalina (Tomcat) JSP 緩衝區異常截斷 Bug 排查實錄

現象

JSP 頁面中後部標簽（BSelectTag）因缺少方法拋 NoSuchMethodError，導致前部標簽（JavaScriptStaticTag）輸出緩衝區內容截斷，且無任何異常日誌輸出。表現為驗證腳本只輸出一半，程式看似正常結束。

排查過程

1. 在 doEndTag 斷點、輸出調試信息 → 日誌無輸出。
2. 懷疑 StringBuffer 溢出 → 改分段輸出、改 getString() 由父標簽輸出 → 現象不變。
3. 跳過該標簽，發現後續標簽確有 NoSuchMethodError（昨晚誤刪接口方法）。
4. 修復後錯誤消失；恢復錯誤，異常重現。

根因分析

JSP 編譯為 Servlet 後，整個頁面輸出是統一緩衝區、單一執行流。後部代碼拋出錯誤（甚至是 Error 級別）導致 _jspService() 中斷，緩衝區尚未 flush() 即異常退出，**前部已寫入緩衝區的內容被截斷輸出，且容器未捕獲記錄異常**（可能被 JVM 錯誤處理機制吞噬）。

經驗總結

• 遇到「輸出截斷、無日誌、程式邏輯正常」→ **先全編譯相關類，排除編譯/部署不一致**。
• JSP 標簽手動調用（parentTag.doStartTag()）繞過容器生命週期，極易導致緩衝區管理混亂，**建議完全交由容器管理標簽生命週期**。
• 生產環境務必開啟容器錯誤頁面與詳細異常日誌級別。

後續優化

精簡 validator-rules.xml 輸出，僅輸出當前表單所需驗證腳本，減少緩衝區壓力與頁面體積。