只要頁面與後端都是 UTF-8,jQuery ajax 幾乎不會出問題,POST、GET 都能拿到正確內容。但只要牽扯到 GBK,情況就變了:
這兩種組合下,後端往往收到一堆奇怪字元或問號。
方案一:全部改成 UTF-8。最乾淨,卻也最不現實。國內大量老系統以 GBK 營運,為了單一問題把整個專案轉碼,成本與風險都不成比例。
方案二:二次編碼。前端在送出前用 encodeURIComponent 編一次,後端收到後再解一次(例如 Java 端呼叫 URLDecoder.decode)。這是目前最多人採用的做法,但缺點很明顯:前後端各要記得手動加一次,稍不留神就會漏掉,而且編解碼邏輯混進了業務程式碼裡。
以傳統表單 POST 送出時,瀏覽器會依目前頁面編碼自動編一次,伺服器端接收表單時也會自動解一次。這兩步對程式通常是透明的,所以我們感覺不到;一旦手動再加一層,就變成所謂的「二次編碼」。
但改用 AJAX 送出時,瀏覽器不會替我們編碼,這件事被交給了 jQuery。在 jQuery 的 ajax 方法裡可以看到:
ajax: function( s ) {
s = jQuery.extend(true, s, jQuery.extend(true, {}, jQuery.ajaxSettings, s));
var jsonp, jsre = /=?(&|$)/g, status, data,
type = s.type.toUpperCase();
// convert data if not already a string
if ( s.data && s.processData && typeof s.data !== "string" )
s.data = jQuery.param(s.data);
........
}
也就是說,只要設定了 data,jQuery 內部就會呼叫 jQuery.param 把參數序列化,而這個函式用的是 encodeURIComponent:
jQuery.param = function( a ) {
var s = [ ];
function add( key, value ){
s[ s.length ] = encodeURIComponent(key) + '=' + encodeURIComponent(value);
};
if ( jQuery.isArray(a) || a.jquery )
jQuery.each( a, function(){ add( this.name, this.value ); });
else
for ( var j in a )
if ( jQuery.isArray(a[j]) )
jQuery.each( a[j], function(){ add( j, this ); });
else
add( j, jQuery.isFunction(a[j]) ? a[j]() : a[j] );
return s.join("&").replace(/%20/g, "+");
}
問題的根源就在這裡:encodeURIComponent 固定以 UTF-8 進行編碼,沒有其他 API 能讓它改走 GBK。
關鍵在 escape。它對 0–255 以外的 Unicode 值會輸出 %u**** 格式,而在其餘情況下,escape、encodeURI、encodeURIComponent 的結果其實是一樣的。也就是說,escape 保留的字元會落在系統預設編碼(在 GBK 環境下就是 GBK)上,這正好是我們要的行為。
兩個函式「不編碼的字元」清單略有差異:
差別中要特別注意加號:escape 不處理 +,若內容含加號,伺服器會把它譯成空格。因此必須自行把 + 編碼掉。
jQuery.param = function( a ) {
var s = [ ];
var encode = function(str){
str = escape(str);
str = str.replace(/\+/g, "%2B");
return str;
};
function add( key, value ){
s[ s.length ] = encode(key) + '=' + encode(value);
};
if ( jQuery.isArray(a) || a.jquery )
jQuery.each( a, function(){ add( this.name, this.value ); });
else
for ( var j in a )
if ( jQuery.isArray(a[j]) )
jQuery.each( a[j], function(){ add( j, this ); });
else
add( j, jQuery.isFunction(a[j]) ? a[j]() : a[j] );
return s.join("&").replace(/%20/g, "+");
}
這段程式不需要動到 jQuery 的原始檔,只要在你的專案腳本中貼上,並且確保它在 jQuery 之後載入,就能覆蓋原方法。
初步驗證顯示,這段程式在 UTF-8 環境下也能正常運作,推測是因為內容最終仍是以 Unicode escape 形式傳遞的緣故。如此一來,前端不必手動編一次、後端也不必手動解一次,GBK 環境下的 ajax POST 就不再是問題。
不過還是得說清楚:escape 早已被標記為即將淘汰的函式,這個方案本質上是順著舊瀏覽器的行為在鑽空子。若專案有長期維護計畫,正解永遠是把編碼統一遷移到 UTF-8;上述做法適合作為過渡期的權宜之計。