解決 HTML 網頁編碼導致 JSP 頁面亂碼的核心原因與修正方法

在開發 JSP 應用時，經常會遇到一個令人頭疼的問題：明明在 JSP 頁面已經做了中文亂碼處理，前端卻依然顯示亂碼。罪魁禍首往往藏在 HTML 頁面頭部一行看似不起眼的代碼中：

<meta http-equiv="Content-Type" content="text/html; charset=GBK">

如果這裡的 charset 被錯誤地設置為 UTF-8，而後端 JSP 實際輸出的是 GBK 編碼，或者雙方編碼不一致，就會導致瀏覽器以錯誤的字符集解碼頁面，從而產生亂碼。即使 JSP 端使用了 request.getParameter(...).getBytes("ISO-8859-1") 這類轉碼邏輯，也無法彌補前後端編碼協議不匹配的根本缺陷。

核心原則：前後端編碼必須統一

解決亂碼的鐵律只有一條：HTML 頁面聲明的 charset、JSP page 指令的 pageEncoding、Servlet 請求/響應編碼、資料庫連接編碼，這四者必須保持完全一致。建議全站統一採用 UTF-8，因為它支援全球字符，避免了 GBK 等編碼在跨系統交互時的兼容性陷阱。

正確的配置檢查清單

1. HTML 頁面：<meta charset="UTF-8">（HTML5 簡寫）或 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">。
2. JSP 頁面指令：<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>。
3. Servlet / Filter 中：
   request.setCharacterEncoding("UTF-8");
response.setContentType("text/html;charset=UTF-8");
4. Tomcat server.xml：在 <Connector> 節點添加 URIEncoding="UTF-8"，解決 GET 請求中文參數亂碼。
5. 資料庫連接串：MySQL 為例 jdbc:mysql://...?characterEncoding=UTF-8&useUnicode=true。

避免常見誤區

• 不要在 JSP 中手動拼裝 ISO-8859-1 轉碼：new String(request.getParameter("uname").getBytes("ISO-8859-1"), "UTF-8") 這種寫法極易出錯，且在 Tomcat 8+ 已不再需要，正確配置編碼後框架會自動處理。
• 不要混用 GBK 與 UTF-8：若歷史系統必須用 GBK，請確保上述五處全部改為 GBK，但強烈建議遷移至 UTF-8。
• 檢查文件本身編碼：IDE 保存 JSP/HTML 文件時編碼必須與聲明一致，否則「文件實際編碼」與「聲明編碼」不符同樣會亂碼。

快速驗證步驟

1. 在瀏覽器開發者工具 Network 標籤查看 Response Headers 的 Content-Type 是否包含 charset=UTF-8。
2. 在 Console 執行 document.characterSet 確認瀏覽器實際使用的解碼集。
3. 若不一致，按清單逐項排查配置遺漏處。

徹底解決亂碼，關鍵在於「統一」而非「轉碼」。建立標準化的編碼規範並貫徹執行，才能從根源上杜絕亂碼問題。