萬盛學電腦網

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

JSP 常見執行錯誤與解決方案彙總

前言

JSP 開發過程中常遇到各類執行期錯誤,本文整理高頻錯誤、根因分析與解決方案,助您快速排查。

1. javax.naming.NameNotFoundException: Name jdbc is not bound in this Context

原因: JNDI 資料源名稱未正確綁定,或 META-INF/context.xml 設定錯誤(<Context> 標籤名稱拼寫、資源名稱不符)。

解決:

  • 檢查 context.xml 中 <Resource name="jdbc/YourDS" .../> 的 name 屬性。
  • 確認 web.xml <resource-ref> 的 <res-ref-name>jdbc/YourDS</res-ref-name> 一致。
  • Context 標籤只能是 <Context>,不可寫成其他名稱。

2. java.lang.IllegalStateException: Attempt to clear a buffer that's already been flushed

現象: response.sendRedirect() 後仍有輸出,或緩衝區已衝刷又嘗試清空。

解決:

  • sendRedirect 後立即 return,避免後續程式碼輸出。
  • 或設定頁面指令擴大緩衝區:<%@ page buffer="10kb" %>(預設 8kb)。
  • 確保重導向前無任何 out.print、空白字元、include 等輸出行為。

3. The type Date is ambiguous

原因: 同時 import java.sql.* 與 import java.util.*,兩個套件皆有 Date 類別,編譯器無法判斷使用哪一個。

解決:

  • 具體指定完整類名:java.util.Date today = new java.util.Date();
  • 或單獨 import 需要的類別,避免通配符 import。

4. MySQL 插入中文亂碼

現象: 資料庫預設 UTF-8,JSP 插入資料出現亂碼。

解決:

  • 連線字串加編碼參數:jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=utf-8
  • 插入前轉碼:new String(request.getParameter("param").getBytes("ISO-8859-1"), "UTF-8")(僅適用 GET 參數)。
  • 推薦:配置 Filter 統一設定 request.setCharacterEncoding("UTF-8"),資料庫、表、欄位皆設 utf8mb4。

5. 頁面顯示/表單提交中文亂碼

現象: 表單提交「保存」等中文按鈕值,後端比對失敗。

解決:

  • JSP 頁面加編碼指令:<%@ page pageEncoding="UTF-8" contentType="text/html;charset=UTF-8" %> + request.setCharacterEncoding("UTF-8") + response.setCharacterEncoding("UTF-8")。
  • 隱藏欄位傳遞數字代碼替代中文值:<input type="hidden" name="action" id="hide">,JS 設值 document.getElementById('hide').value = 1(1=保存, 2=重置...)。

6. <input> 可用 value 取值,<textarea> 必須放在標籤內文

錯誤: <textarea value="<%= bean.getContent() %>"></textarea>(不顯示)。

正確: <textarea><%= bean.getContent() %></textarea>。textarea 的內容由標籤內文決定,而非 value 屬性。

快速排查清單

  1. 檢查 Tomcat 日誌完整堆疊追蹤。
  2. 確認編碼鏈路:瀏覽器 → Tomcat → JSP → Java → DB 皆為 UTF-8。
  3. JNDI 資源名稱大小寫、路徑完全一致。
  4. 重導向後立即 return,避免緩衝區衝突。
  5. 避免通配符 import 導致類別名稱衝突。
copyright © 萬盛學電腦網 all rights reserved