萬盛學電腦網

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

JSP 頁面 URL 參數中文亂碼的完整解決方案

問題成因

JSP 頁面透過 URL(GET 請求)或表單提交(POST 請求)傳遞中文參數時,若編碼設定不一致,伺服器端接收到的參數會出現亂碼(如「????」或亂碼字元)。根本原因在於:瀏覽器編碼、Tomcat 解碼、JSP 頁面編碼、Java 字串處理四個環節編碼不一致。

方案一:修改 Tomcat server.xml(針對 GET 請求)

編輯 $CATALINA_HOME/conf/server.xml,找到 <Connector> 標籤,新增 URIEncoding="UTF-8"(或 GBK/GB2312):

<Connector port="8080" maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
  enableLookups="false" redirectPort="8443" acceptCount="100"
  connectionTimeout="20000" disableUploadTimeout="true"
  URIEncoding="UTF-8" />

優點: 一勞永逸,全域生效。
缺點: 耦合伺服器設定,移植性差;僅對 GET 請求有效,POST 需配合其他方案。

方案二:JSP 頁面指定編碼(針對 POST 請求)

在每個 JSP 頁面頂部加入:

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

說明:

  • pageEncoding:指定 JSP 檔案本身的儲存編碼(編譯階段讀取用)。
  • contentType:指定回應給瀏覽器的 Content-Type 標頭編碼。
  • request.setCharacterEncoding:指定請求參數解碼編碼(必須在讀取參數前呼叫)。

建議: GET/POST 兩種方案同步使用,並統一專案編碼為 UTF-8。

方案三:Java 程式碼手動轉碼(不推薦常規使用)

<%= new String(request.getParameter("param").getBytes("ISO-8859-1"), "UTF-8") %>

利用 Tomcat 預設以 ISO-8859-1 解碼 GET 參數的特性,手動轉回 UTF-8。缺點是程式碼散落、易漏、效能稍差。

方案四:自定義 JSTL 標籤庫(進階封裝)

  1. 編寫標籤處理類(實作 Tag 或繼承 TagSupport)。
  2. 編寫 .tld 標籤描述檔,定義標籤名、屬性、處理類對應。
  3. 將 .tld 放入 WEB-INF/ 或打包進 JAR 的 META-INF/。
  4. JSP 頁面引入 <%@ taglib prefix="c" uri="..." %> 使用。

此法將轉碼邏輯封裝於標籤內,JSP 頁面乾淨,適合大型專案統一管理。

綜合建議

  1. 專案統一採用 UTF-8:資料庫、連線字串、JSP、Tomcat、Java 來源檔編碼。
  2. Tomcat server.xml 設定 URIEncoding="UTF-8"(解決 GET)。
  3. 所有 JSP 頁面統一加入三行編碼指令(解決 POST)。
  4. 或採用 Filter 統一攔截請求設定 request.setCharacterEncoding("UTF-8"),避免每頁重複撰寫。
copyright © 萬盛學電腦網 all rights reserved