做專案時遇到 Ajax 中文亂碼,折騰掉我一整個下午,最後總算收拾乾淨。把過程記錄下來,希望對還在這題打轉的人有點幫助。
眾所周知,用 Ajax 傳送與接收中文參數時,若兩端不做相應處理就會亂碼。網上相關文章不少,但多半在講 ASP 與 JSP,我用的是 PHP,翻了一圈始終沒找到合適的答案,只好自己試。
症狀很有指向性:未做任何處理時,IE 正常,Firefox 亂掉。我把收到的參數寫進文字檔,看起來沒問題;再把查詢語句印出來比對(我要從資料庫撈出與參數相關的內容),才發現 IE 與 Firefox 送出的字串雖然肉眼看起來一樣,前後連接處卻有細微差異——這是編碼問題。
Ajax 送資料時採 UTF-8 編碼,而我的頁面是 GB2312,所以伺服器端必須轉碼:
$str = iconv("UTF-8", "GB2312", $str);
改完在 Firefox 上順利通過,正以為大功告成,回到 IE 卻發現伺服器收到的參數沒有值。低頭一看,送請求前有設定 setRequestHeader("Content-Type","application/x-www-form-urlencoded"),問題就浮現了:得先在送出路徑時編碼。
geturl = encodeURI(geturl);
geturl = encodeURI(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");
// JSP:回傳 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");
亂碼的本質是「編碼宣告」與「實際編碼」不一致。除錯時依序檢查三件事:頁面 meta 宣告的 charset、檔案實際存檔的編碼、伺服器回應標頭的 charset。三者對齊之後,再回頭看是否需要 encodeURI 與 urldecode 這一層來回轉換——只要順序對(先解碼、後轉碼),跨瀏覽器的行為就能一致。