萬盛學電腦網

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

JSP 頁面傳值中文亂碼的五種解決方法與最佳實踐

問題重現

a.jsp 表單提交中文參數 name=中文 到 b.jsp,接收端顯示「??????」或亂碼字元。

五種解決方法對比

方法一:修改接收頁 pageEncoding 為 ISO-8859-1 + 瀏覽器手動切編碼 ❌ 不推薦

<%@ page pageEncoding="ISO-8859-1" %>

瀏覽器手動切換編碼為 GB2312 才能正常顯示。**不可行**:使用者無法手動切編碼,且破壞頁面其他中文顯示。

方法二:接收端手動轉碼(經典修補法) ✅ 可行但治標不治本

String name = new String(request.getParameter("name").getBytes("ISO-8859-1"), "GB2312");

原理: Tomcat 預設以 ISO-8859-1 解碼 GET 參數,手動按原編碼取回位元組再按目標編碼重組。
缺點: 程式碼散落、易漏、POST 請求需配合 request.setCharacterEncoding、不支援多編碼環境。

方法三:改 POST + 配置編碼 Filter ✅ 推薦

  1. 表單改 method="POST"。
  2. 配置 CharacterEncodingFilter(Spring 提供 org.springframework.web.filter.CharacterEncodingFilter 或自寫)。
  3. web.xml 映射 /*,設定 encoding=UTF-8、forceEncoding=true。

限制: 僅解決 POST,GET 仍需 Tomcat 設定。

方法四:修改 Tomcat server.xml URIEncoding ✅ 解決 GET

<Connector port="8080" ... URIEncoding="UTF-8" />

限制: 僅解決 GET,POST 需配合 Filter。Tomcat 8+ 預設即為 UTF-8。

方法五:雙管齊下(Filter + URIEncoding)✅ 最佳實踐

<!-- web.xml -->
<filter>
  <filter-name>encodingFilter</filter-name>
  <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
  <init-param>
    <param-name>forceRequestEncoding</param-name>
    <param-value>true</param-value>
  </init-param>
  <init-param>
    <param-name>forceResponseEncoding</param-name>
    <param-value>true</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>encodingFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

同時在 server.xml 設定 URIEncoding="UTF-8"。GET/POST 皆正常,一次配置全專案生效。

完整編碼鏈路檢查清單

環節設定驗證方式
JSP 檔案儲存編碼UTF-8 (IDE 設定)十六進位編輯器檢查中文位元組
JSP pageEncodingUTF-8頁面指令
JSP contentTypetext/html;charset=UTF-8頁面指令 / Response Header
request.setCharacterEncodingUTF-8 (Filter 統一設定)Filter 程式碼 / 除錯斷點
Tomcat URIEncodingUTF-8 (server.xml Connector)GET 參數正確解碼
資料庫連線useUnicode=true&characterEncoding=utf-8JDBC URL / 插入中文驗證
資料庫/表/欄位編碼utf8mb4 / utf8mb4_unicode_ciSHOW CREATE TABLE
Java 原始檔編碼UTF-8 (IDE / javac -encoding)編譯無警告

結論

**方法五(Filter + URIEncoding)為標準解法**,徹底解決 GET/POST 中文亂碼。舊專案若無法加 Filter,至少確保方法二、四同時到位。新專務必從專案模板建立時就納入編碼 Filter。

copyright © 萬盛學電腦網 all rights reserved