JSP 報錯無法定位源文件：編譯後類名混淆、建議升級容器或改用模板引擎

現象分析

堆疊顯示 org.apache.jsp.out._20150108145057._1420700842202_jsp._jspService，這是 JSP 編譯生成的 Servlet 類名，無法直接對應原始 .jsp 檔名。

根本原因

• Tomcat/Jasper 將 JSP 編譯為 _jsp.java 再編譯為 .class，類名採用時間戳+雜湊命名。
• 運行時拋出異常只保留編譯後類名，除非啟用 Source Map 或容器支援 JSR-45，否則無法自動映射回源文件。

緩解方案

1. 升級容器版本（Tomcat 9+ / Jetty 9+）

• 較新版本對 JSR-45 支援更好，IDE（IntelliJ IDEA / Eclipse）可直接在除錯器中映射到 .jsp 行號。

2. 開啟開發模式編譯參數

或在 catalina.sh 加入：CATALINA_OPTS="-Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false"

3. 手動定位技巧

1. 從異常行號 _1420700842202_jsp.java:1468 反推：打開 work/Catalina/localhost/yourApp/org/apache/jsp/out/... 對應 .java 檔，看該行代碼上下文。
2. 搜尋關鍵字（如 FileInputStream、/proc/self/task）在專案 .jsp 中定位。
3. 日誌加入 log4j2 MDC 標記請求 ID，關聯存取日誌縮小範圍。

4. 根治：避免在 JSP 寫 Java 代碼（Scriptlet）

• 改用 JSTL + EL 或 Thymeleaf / FreeMarker / Velocity 模板引擎，邏輯移至 Controller/Service，模板純展示，編譯錯誤直接指向模板檔與行號。

總結

JSP 編譯後類名混淆導致無法定位源文件，**屬於 JSP 技術債務**。短期靠升級容器、手動反推緩解；長期**必須遷移至現代模板引擎**，徹底消除 Scriptlet 並獲得可維護的除錯體驗。