JSP 頁面透過 URL(GET 請求)或表單提交(POST 請求)傳遞中文參數時,若編碼設定不一致,伺服器端接收到的參數會出現亂碼(如「????」或亂碼字元)。根本原因在於:瀏覽器編碼、Tomcat 解碼、JSP 頁面編碼、Java 字串處理四個環節編碼不一致。
編輯 $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 頁面頂部加入:
<%@ 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。
<%= new String(request.getParameter("param").getBytes("ISO-8859-1"), "UTF-8") %>
利用 Tomcat 預設以 ISO-8859-1 解碼 GET 參數的特性,手動轉回 UTF-8。缺點是程式碼散落、易漏、效能稍差。
Tag 或繼承 TagSupport)。.tld 標籤描述檔,定義標籤名、屬性、處理類對應。.tld 放入 WEB-INF/ 或打包進 JAR 的 META-INF/。<%@ taglib prefix="c" uri="..." %> 使用。此法將轉碼邏輯封裝於標籤內,JSP 頁面乾淨,適合大型專案統一管理。
server.xml 設定 URIEncoding="UTF-8"(解決 GET)。request.setCharacterEncoding("UTF-8"),避免每頁重複撰寫。