AJAX 傳中文變亂碼,是每個 Java Web 初學者都會撞上的牆。問題可能出在四個不同的地方,得逐層檢查才能定位。
一筆中文資料要從瀏覽器走到 Servlet,會經過好幾次編碼解碼:瀏覽器把字串編碼成位元組 → 網路傳輸 → 容器(Tomcat)解碼 → Servlet 取得字串 → 回應時再編碼一次。任何一環的編碼設定不一致,就會在那裡產生亂碼。
而 GET 與 POST 的問題點不同,這是最容易搞混的地方:GET 的參數放在網址列,由容器在解析 query string 時解碼;POST 的參數放在主體,由 Servlet 請求物件解碼。兩者要設定的地方不一樣。
需求是「使用者輸入帳號、焦點移開時,用 AJAX 送出並由後端判斷是否已存在,再把結果顯示在旁邊」。
package servlet;
import java.io.IOException;
import java.io.PrintWriter;
import java.net.URLDecoder;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class Vali extends HttpServlet {
@Override
protected void service(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
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 (userName.equals("張三")) {
pw.println("錯誤");
} else {
pw.println("正確");
}
}
}
三個地方是解碼的關鍵:
URLDecoder.decode(..., "utf-8"):把頁面傳來的位元組按 UTF-8 解回字串。
response.setContentType("text/html;charset=utf-8"):讓回應以 UTF-8 編碼送出。
順序至關重要:這個 setContentType 必須寫在任何 getWriter() 之前。一旦呼叫了 getWriter(),回應的編碼就已經決定並開始輸出,之後再改設定不會生效——這是很多人「明明設了卻還是亂碼」的直接原因。
另外要注意:POST 要解碼,GET 通常不需要。上例用了 URLDecoder.decode(),適合 POST;若提交方式是 GET, Tomcat 已經在解析 query string 時處理過編碼,再解一次反而會出錯。GET 的正確寫法是設定編碼後重組字串:
request.setCharacterEncoding("utf-8");
String userName = request.getParameter("userName");
userName = new String(userName.getBytes("iso-8859-1"), "utf-8");
iso-8859-1 這段看起來很怪,但它是歷史遺留:舊版 Tomcat 預設用 ISO-8859-1 解碼 query string,所以要先把字串還原成位元組、再用 UTF-8 重新解一次。新版 Tomcat 可以靠設定檔解決,不必寫在程式碼裡(見後面的步驟三)。
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<% String path = request.getContextPath();
String basePath = request.getScheme() + "://" + request.getServerName()
+ ":" + request.getServerPort() + path + "/"; %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">
<title>ajax test</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<script type="text/javascript" src="js/jquery-1.4.4.js"></script>
<script type="text/javascript">
function vali(){
$.ajax({
type: "POST",
url: "/jQuery_Ajax/Vali",
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>
幾個重點:pageEncoding="utf-8" 決定 JSP 檔案本身的解讀;<meta charset> 決定瀏覽器對輸出的解讀;onblur 觸發驗證(比 onkeyup 合理,不會每敲一個字就發請求);$("span").text(data) 把結果填進提示位置。
若改用 GET,只需換掉 type 與 data:
function vali(){
$.ajax({
type: "GET",
url: "/jQuery_Ajax/Vali",
data: encodeURI("userName=" + $(":text").val()),
success: function (data) { $("span").text(data); }
});
}
<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>
原範例寫了 encodeURI(encodeURI(...)),雙重編碼。這是一個流傳很廣的「土法煉鋼」技巧:某些環境下單層編碼仍會出問題,兩層之後剛好能讓後端解出正確結果。
但這麼做並不正確。它的本質是「用錯誤的編碼去補另一個錯誤」,一旦你把根本問題(編碼設定不一致)修好,雙重編碼反而會產生新的亂碼。正確做法是把編碼統一設為 UTF-8,然後不要自己編碼——直接傳物件讓 jQuery 處理:
data: { userName: $(":text").val() }
一、頁面編碼:確認是 UTF-8,且 <meta> 在 <head> :first 個位置(前 1024 位元組內)。
<meta http-equiv="content-type" content="text/html;charset=utf-8">
二、Servlet 回應編碼:在 doPost 或 doGet 的最開頭加上:
response.setContentType("text/xml;charset=utf-8");
三、Tomcat 連接器設定:在 TOMCAT_HOME/conf/server.xml 的 Connector 加上 URIEncoding:
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
redirectPort="8443" URIEncoding="utf-8" />
這個設定決定 Tomcat 如何解碼 GET 的 query string。少了它,前面兩步做完了 GET 仍然會亂碼。
四、全域編碼過濾器:在專案裡新增 filter,把所有請求統一轉為 UTF-8:
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
throws IOException, ServletException {
req.setCharacterEncoding("utf-8");
res.setCharacterEncoding("utf-8");
chain.doFilter(req, res);
}
用過濾器的好處是不必在每個 Servlet 裡重複寫,一處設定全站生效。
做完以上四步問題依舊,這時不要繼續盲猜,直接去看實際送出的內容。開啟瀏覽器的開發者工具 → Network → 點進那個請求,檢查 Content-Type 位在 IE 與 Firefox 下的差異:
IE:contentType: "application/x-www-form-urlencoded"
Firefox:contentType: "application/x-www-form-urlencoded;charset=UTF-8"
差別就在 Firefox 多了 ;charset=UTF-8。這代表 jQuery 送出的 Content-Type 沒有宣告編碼,而伺服器在缺少這個資訊時會用預設編碼解碼,於是亂碼。
修改 jquery-1.x.x.js,找到 contentType 的預設值並補上 charset:
// 修改前 contentType: "application/x-www-form-urlencoded", // 修改後 contentType: "application/x-www-form-urlencoded;charset=UTF-8",
存檔重新整理,問題解決。
直接改 jQuery 的原始碼並不是好習慣——下次升版就白改了。同樣的效果可以用 $.ajaxSetup() 全域設定,或寫在每次呼叫裡:
$.ajaxSetup({
contentType: "application/x-www-form-urlencoded; charset=UTF-8"
});
// 或者只對單一請求生效
$.ajax({
type: "POST",
url: "Vali",
contentType: "application/x-www-form-urlencoded; charset=UTF-8",
data: { userName: value },
dataType: "json"
});
排查編碼問題時,不要靠猜、要靠比對。同一個請求,在正常的環境與出錯的環境下,把 request header、response header、實際位元組全部攤開來對照,差異點就是答案所在。
前面那四步之所以沒解決問題,是因為它們都是「常見原因」而非「你的原因」。而第五步的 header 比對之所以奏效,是因為它直接觀察事實。這個思路適用於所有類型的 bug,不只是編碼。
Spring 專案可以直接靠設定解決,不必寫任何程式碼:
<!-- Spring MVC 的 characterEncodingFilter,forceEncoding 設為 true --> <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>forceEncoding</param-name><param-value>true</param-value></init-param> </filter>
而 Spring Boot 只要把 spring.http.encoding.charset=UTF-8 放進設定檔即可,內建就已經處理好。此外,所有頁面與檔案一律存成 UTF-8(不帶 BOM),這個習慣能消滅九成以上的編碼問題。