AJAX 傳中文變亂碼,是每個人都會撞上的經典問題。網上討論很多,但大半在講 ASP 與 JSP,PHP 的場景反而少;而且症狀往往比想像中刁鑽——同一段程式,IE 正常、Firefox 亂碼,這種情況尤其惱人。以下把整個排查過程與解法完整走一遍。
第一種:前端送資料給後端,後端收到的是亂碼。
第二種:後端輸出中文給前端,前端顯示成亂碼。
兩者的成因與解法完全不同,先分類再動手,能省下大量瞎試的時間。
症狀通常是:IE 正常,Firefox 亂掉。我當時先把收到的參數寫進文字檔觀察,看不出問題;再把參數拼進查詢語句輸出來看(因為要從資料庫撈對應資料),才發現 IE 與 Firefox 送出的字串有細微差異——看起來一樣,實際編碼不同。到這裡就確認了:這是編碼問題。
關鍵知識是:AJAX 送出的資料一律採用 UTF-8 編碼。所以如果你的頁面本身是 GB2312,就必須在伺服器端做一次轉換:
$str = iconv("UTF-8", "GB2312", $str);
測完 Firefox 正常了,以為搞定,結果換到 IE 又壞——後端收到的參數直接沒值。低頭一看,前端設了這行:
XMLHttp.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
問題就在這裡。解法是在送出前先做 URL 編碼:
geturl = encodeURI(geturl);
// 需要兩層的話也可以寫成
geturl = encodeURI(encodeURI(geturl));
XMLHttp.open("GET", geturl, true);
對應地,後端要先解碼再轉編碼:
$str = urldecode($str); // 先解碼
$str = iconv("UTF-8", "GB2312", $str); // 再轉碼
順序很重要:解碼必須在編碼轉換之前,顛倒過來會拿到錯誤的值。做完這兩步,IE 與 Firefox 就都正常了。
這類問題網上答案比較多,原因也好理解:AJAX 在接收 responseText 或 responseXML 時,是按 UTF-8 解碼的。如果伺服器送出的資料不是 UTF-8,接收到的值就可能變成亂碼。
解法是在伺服器端明確指定輸出的編碼:
// JSP:回傳純文字
response.setContentType("text/text;charset=UTF-8");
// 或回傳 XML
response.setContentType("text/xml;charset=UTF-8");
// PHP
header('Content-Type: text/html; charset=GB2312');
// ASP
Response.Charset("GB2312")
// JSP 另一種寫法
response.setHeader("Charset", "GB2312");
在 Java 這邊還有個細節:setContentType() 必須寫在 getWriter() 之前。像這樣:
// 正確
response.setContentType("text/xml;charset=GBK");
PrintWriter out = response.getWriter();
// 錯誤——setContentType 會失效,結果一樣是亂碼
PrintWriter out = response.getWriter();
response.setContentType("text/xml;charset=GBK");
這個坑我當初卡了很久,純粹是因為沒仔細看程式碼的先後順序。
上面這套來回轉碼的做法,能解決眼前問題,但本質上是在補破網。真正省事的作法是從頭到尾統一 UTF-8:頁面宣告 UTF-8、資料庫連線與表編碼用 UTF-8、伺服器輸出標頭也是 UTF-8。這樣 AJAX 送出的資料天生就對得上,一行 iconv 都不用寫。
如果今天你正在為亂碼頭痛,先把「前端編碼 → 傳輸編碼 → 後端解碼 → 資料庫編碼」這條鏈條每一段都攤開來看一遍,問題幾乎一定會在其中某一段現形。