用 XHR 發出 GET 請求時,若 URL 的查詢參數帶有中文,後端常常拿不到正確的中文字串:
request = new ActiveXObject("Microsoft.XMLHTTP");
request.open("GET", url); // url 中夾帶中文參數
直接把中文塞進 URL,伺服器端解析不出來,於是直覺做法是「先在頁面轉碼,再在後端解碼」。
用 JavaScript 的 escape 把中文轉成 %XX 形式的轉義字元:
function enCode(str){
return escape(str); // 例如「台灣」→ %A8%EC%A7%F5
}
接著用它組出 URL,再交给 open() 送出。
後端有兩種乾淨的做法,都比自行實作編碼表可靠得多:
做法一:讓容器代勞。若使用 Servlet,容器通常已依頁面編碼解析參數,只要明確指定編碼即可:
request.setCharacterEncoding("UTF-8");
String keyword = request.getParameter("keyword");
做法二:自己取出查詢字串再解碼。若因故無法直接取得參數,可先取 query string,再用標準解碼工具還原:
String query = request.getQueryString();
String decoded = URLDecoder.decode(query, "UTF-8");
取得整串解碼後的內容,再自行以 & 切分、以 = 取出目標參數即可。這比手寫 escape 解碼演算法安全得多——手工版本往往漏處理 + 號、非 ASCII 位元組與 %uXXXX 形式,反而埋下更多 bug。
XHR 送出的其實就是一個 HTTP 封包。瀏覽器會依頁面編碼(或 XHR 的預設規則)編碼參數,而頁面若採用 UTF-8、舊版 XHR 實作卻以 GB2312 編碼,兩邊對不上,後端自然看到亂碼。
實務上最穩定的三個原則:
setCharacterEncoding("UTF-8"),不要依賴容器預設;encodeURIComponent() 取代已廢棄的 escape(),因為前者對 UTF-8 的處理才是標準行為。如果整站都採用 GBK/GB2312,確實可以少掉這類困擾;但在多語言環境下,統一 UTF-8 才是長久之計。