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

五大常見錯誤與解決方案

1. javax.naming.NameNotFoundException: Name jdbc is not bound

原因： META-INF/context.xml 資料源配置錯誤或 JNDI 名稱引用失敗。

解決： 檢查 context.xml <Resource> 標籤 name 屬性與程式碼 lookup 名稱一致，標籤名稱只能是 context。

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

現象： response.sendRedirect() 後緩衝區已刷新無法清除。

解決方案：

• sendRedirect 後加 return 結束處理
• 路徑改為相對路徑 ./a.jsp
• 根本解決： 增加頁面緩衝區大小 <%@ page buffer="10kb" %> (預設 8kb)

3. The type Date is ambiguous

原因： 同時匯入 java.sql.* 與 java.util.*，兩者皆有 Date 類別。

解決： 使用完整類別名稱 java.util.Date today = new Date(); 或調整 import 順序/移除多餘 import。

4. 中文亂碼綜合解決

MySQL 插入亂碼：

// 連接字串加編碼參數
String url = "jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=utf-8";

// 插入前轉碼
new String(request.getParameter("param").getBytes("ISO8859-1"), "UTF-8");

頁面表單提交亂碼：

• 隱藏欄位傳遞數字代碼避免中文比對：<input type="hidden" name="action" value="1">
• JavaScript 設定隱藏欄位值：document.getElementById("hide").value = num;
• 頁面統一編碼設定：

<%@ page pageEncoding="utf-8" %>
<%@ page contentType="text/html;charset=utf-8" %>
<% request.setCharacterEncoding("utf-8"); response.setCharacterEncoding("utf-8"); %>

5. textarea 無法用 value 屬性顯示資料

錯誤寫法： <textarea value="<%=bean.getContent()%>"></textarea>

正確寫法： 內容放在標籤內部：

<textarea name="contents"><%=bean.getContents()%></textarea>

除錯心法

1. 閱讀完整堆疊追蹤，定位錯誤行號
2. 檢查 import 衝突、編碼一致性、緩衝區大小
3. 善用瀏覽器開發者工具檢查網路請求與回應
4. 資料庫操作優先使用 PreparedStatement 防注入與編碼問題