用 jQuery 發 AJAX 請求時,中文傳到後端變成問號或亂碼,是每個人都會撞上一次的經典問題。它不是 jQuery 的錯,而是編碼不一致:瀏覽器用一種編碼送出位元組,伺服器用另一種編碼解讀,同一串位元組被賦予了錯誤的意義。
文字在網路上傳遞時,本質上是一串位元組。編碼就是「位元組 ↔ 字元」的對照表。只要送出的編碼與接收端假設的編碼不同,中文一定亂。所以解法永遠只有一個方向:讓兩端對齊。以下用一個使用者名重複檢查的小專案走一遍。
新建 Web 專案(此例預設 GBK),在 WebRoot 下建立 js 目錄並放入 jquery-1.4.4.js。頁面與伺服器使用的編碼務必記錄下來,後面每一步都要對照。
package servlet;
import java.io.IOException;
import java.io.PrintWriter;
import java.net.URLDecoder;
import javax.servlet.ServletException;
import javax.servlet.http.*;
public class Vali extends HttpServlet {
@Override
protected void service(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// POST:先解碼再取值
String userName = URLDecoder.decode(request.getParameter("userName"), "utf-8");
System.out.println(userName);
// 設定回應編碼
response.setContentType("text/html;charset=utf-8");
PrintWriter pw = response.getWriter();
if ("張三".equals(userName)) {
pw.println("錯誤");
} else {
pw.println("正確");
}
}
}
一、URLDecoder.decode(..., "utf-8") 把前端編碼而來的字串還原成正確文字,這是 POST 的關鍵。
二、response.setContentType("text/html;charset=utf-8") 決定回應怎麼被瀏覽器解讀,少了它就會換成回程亂碼。
三、這行必須寫在取得 getWriter() 之前。一旦呼叫了 getWriter(),回應的編碼就被鎖定,之後再設定完全無效。這是最高頻的踩坑點。
四、上面的解碼方式只適用 POST。若前端用 GET,參數是走網址傳的,解讀方式完全不同:
request.setCharacterEncoding("utf-8");
String userName = request.getParameter("userName");
userName = new String(userName.getBytes("iso-8859-1"), "utf-8");
這裡 iso-8859-1 是 Servlet 容器解析查詢字串時的預設編碼,先取回原始位元組、再用 utf-8 重新解讀,是 Tomcat 未設定 URIEncoding 時的補救寫法。根本解法是設定容器的 URIEncoding,見文末。
<%@ page language="java" pageEncoding="utf-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<script src="js/jquery-1.4.4.js"></script>
<script type="text/javascript">
function vali(){
$.ajax({
type: "POST",
url: "/jQuery_Ajax/Vali",
// 注意 encodeURI 用了兩層,配合後端的 URLDecoder 解一層
data: encodeURI(encodeURI("userName=" + $(":text").val())),
success: function(data){
$("span").text(data);
}
});
}
</script>
</head>
<body>
用戶名:<input type="text" name="userName" onblur="vali();" /><span></span><br/>
密碼:<input type="password" name="password" />
</body>
</html>
若改用 GET,data 只需編碼一層:
function vali(){
$.ajax({
type: "GET",
url: "/jQuery_Ajax/Vali",
data: encodeURI("userName=" + $(":text").val()),
success: function(data){ $("span").text(data); }
});
}
關於 encodeURI 的層數:編碼一次、解碼一次才對稱。原範例前端編兩層、後端只解一層,這種不對稱的寫法能跑是因為湊巧抵銷了某些中介層的行為,並不可靠。建議統一成「前端編一層、後端解一層」,或乾脆用 encodeURIComponent 對單一參數值編碼,語意更明確。
<servlet>
<servlet-name>Vali</servlet-name>
<servlet-class>servlet.Vali</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Vali</servlet-name>
<url-pattern>/Vali</url-pattern>
</servlet-mapping>
亂碼的來源可能散落在整條鏈路上,逐項排查比盲目嘗試有效:
1. 頁面編碼——確認 <meta http-equiv="content-type" content="text/html;charset=utf-8"> 存在,且檔案本身的實際編碼與之一致(用記事本另存的檔案常常名不副實)。
2. Servlet 回應編碼——在 doPost/doGet 裡加上 response.setContentType("text/xml;charset=utf-8"),並記得它要在 getWriter() 之前。
3. Tomcat 連接器——編輯 TOMCAT_HOME/conf/server.xml,為 Connector 加上 URIEncoding="utf-8":
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
redirectPort="8443" URIEncoding="utf-8" />
4. 全域編碼過濾器——在專案中新增 filter,於 doFilter 裡對 request 與 response 都設定 utf-8。這是 Java Web 專案最一勞永逸的做法,也可以直接用 Spring 的 CharacterEncodingFilter。
5. 比對不同瀏覽器的請求標頭——用開發者工具看 IE 送出的 contentType 是 application/x-www-form-urlencoded,而 Firefox 送的是 application/x-www-form-urlencoded;charset=UTF-8。差異出現在這裡,就代表 IE 沒有宣告自己的編碼。
6. 必要時修改 jQuery 的預設 contentType——舊版 jQuery 在 ajaxSetup 中寫死了 contentType: "application/x-www-form-urlencoded",可以在自己的呼叫裡覆寫它,而不需要去改 jquery.js 原始檔(改原始檔會在下次升版時全部消失,是很糟的習慣):
$.ajax({
url: "/jQuery_Ajax/Vali",
type: "POST",
contentType: "application/x-www-form-urlencoded;charset=UTF-8",
data: { userName: $("#userName").val() },
success: function(data){ $("span").text(data); }
});
與其逐個手動 URLDecoder.decode,更好的策略是在專案入口統一處理:設定好 filter、設定好 Tomcat 的 URIEncoding、統一專案與資料庫都用 UTF-8。這樣業務程式碼裡就不必再想編碼的事。逐頁補救的寫法短期看似有效,專案一大就會變成難以追查的地雷區。