用 Ajax 送出中文參數時遇到亂碼,很多人第一時間會懷疑編碼設定,但其實問題往往出在 escape() 的編碼規則與後端解碼方式不相符。
escape() 早期是依 ISO-8859-1 對字元做 URL 編碼,這種情況下後端用 request.getParameter() 往往就能直接取得原值。但 JavaScript 後續把 escape() 的行為改為 Unicode 編碼,中文會變成 %u4f60 這種形式,於是 JSP/Servlet 端就拿不到可直接使用的參數了。
第一步,在送出前對中文做兩次 escape()。以參數 name、值為「你好」為例,URL 會長得像:
...&name=%25u4f60%25u597d
這樣 request.getParameter() 至少能取到編碼後的字串(% 被編碼成 %25,避免被伺服器提前解開)。
第二步,後端無法用一般的 URLDecoder.decode() 還原這種格式,需要一個能處理 escape()/unescape() 規則的工具函式,把 %uXXXX 逐一轉回字元。
前端送出的部分大致如下:
<script language="javascript">
function get(id){ return document.getElementById(id).value; }
function setting() {
var xmlhttp;
if (window.ActiveXObject) {
xmlhttp = new ActiveXObject("Microsoft.XMLHTTP");
} else {
xmlhttp = new XMLHttpRequest();
}
xmlhttp.onreadystatechange = function() {
if (xmlhttp.readyState == 4) {
if (xmlhttp.status == 200) alert("成功!");
else alert(xmlhttp.status);
}
};
var url = "action.asp?action=setting&rnd=" + Math.random();
xmlhttp.open("POST", url, true);
var senddate =
"title=" + escape(get("title")) +
"&conn_way=" + escape(get("conn_way")) +
"&databasename=" + escape(get("databasename")) +
"&pg_size=" + escape(get("pg_size"));
xmlhttp.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
xmlhttp.send(senddate);
}
</script>
定義:對字串做編碼,使其能在各種機器上被正確讀取。
語法:escape(string),參數為要編碼的字串,回傳值是編碼後的字串副本,部分字元被替換成十六進位轉義序列。
行為:ASCII 字母與數字不編碼,- _ . ! ~ * ' ( ) 也不編碼,其餘字元都會被轉義。可用 unescape() 還原。
重要提醒:escape() 與 unescape() 在 ECMAScript 3 就已被標示為不建議使用,新專案請改用 encodeURIComponent() 與 decodeURIComponent()。前者會把中文編成 UTF-8 的 %E4%BD%A0 形式,後端只要以 UTF-8 解碼即可正確還原,不需要上面那套兩次編碼的繞路寫法。若使用 jQuery 或 fetch,交由函式庫處理參數序列化會更省心。