DIV CSS 佈局教程網

解決 jQuery.ajax 傳遞中文參數亂碼:加上 charset=UTF-8 就好
編輯:JQuery特效代碼     

中文參數傳到後端變成亂碼,是每個 ASP.NET 或 JSP 開發者都會碰到的問題。網路上流傳的「終極方案」多半是前端用 escape(str) 編碼、後端再寫方法解回來,或者靠 System.Text.Encoding various 方法反覆轉換。這些做法都有效,但都是绕路。

真正的差異在哪裡

作者長期使用 Prototype 框架,在 .NET(GB2312)與 JSP(UTF-8)環境下都沒遇過編碼問題。於是他把 Prototype 與 jQuery 的原始碼都拉下來對照,找到了癥結:

  • jQuery 預設:contentType: application/x-www-form-urlencoded
  • Prototype:contentType: application/x-www-form-urlencoded; charset=UTF-8

差的就是後面那段 ; charset=UTF-8。在未明確指定字元集的情況下,瀏覽器會採用 ISO-8859-1(通常稱為 Latin-1),這個字元集只涵蓋西歐語言所需的附加字元,根本沒有中文。於是中文在傳送過程中就被迫降級成了問號或亂碼。

簡單說:jQuery 的 Ajax 在設計之初沒有考慮國際化,用了歐洲的字元集,這才是中文亂碼的根因。而 UTF-8 可以完整表示中文,所以只要顯式宣告使用 UTF-8,問題就解決了。

解法:顯式指定 charset

只需在 jQuery 的設定中加上 charset=UTF-8,不必改 web.config、不必在頁面調編碼,也不需要 escape 再解碼。英文怎麼傳,中文就怎麼傳。

測試用的完整範例

前端 test.html:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312" />
<title></title>
<script type="text/javascript" src="scripts/jquery-1.3.2.min.js"></script>
<script type="text/javascript">
function DoAjax(){
  $.post("AjaxTest.aspx",
    { txt: $("#tbox1").val() },
    function(data){
      $("#AjaxResponse").text(data);
    }
  );
}
</script>
</head>
<body>
<p>
  <a href="javascript:DoAjax();">AjaxTest</a>
  <input name="tbox1" id="tbox1" type="text" />
</p>
<div id="AjaxResponse"></div>
</body>
</html>

後端 AjaxTest.aspx:

<%@ Page Language="C#" ContentType="text/html" ResponseEncoding="gb2312" %>
<script runat="server">
string parms;

void Page_Load(object sender, EventArgs e)
{
    parms = Request["txt"];
    if (String.IsNullOrEmpty(parms))
    {
        Response.Write("Is Null");
    }
    else
    {
        Response.Write(parms);
    }
}
</script>

完整思路整理

要讓中文正確往返,三個環節的編碼必須對齊:頁面本身的 charset、AJAX 請求送出的 contentType 字元集、以及伺服器端的 ResponseEncoding 與 requestEncoding。任何一處不一致,就會在中途被解錯。

在實際操作上,若使用 $.ajax(),直接寫:

$.ajax({
  url: "AjaxTest.aspx",
  type: "POST",
  contentType: "application/x-www-form-urlencoded; charset=UTF-8",
  data: { txt: $("#tbox1").val() },
  success: function (data) { $("#AjaxResponse").text(data); }
});

這比修改 jQuery 原始檔要務實得多——改原始檔雖然能一勞永逸,但每次升級函式庫都要重改一次,維護成本太高。在呼叫處明確指定,才是可持續的做法。

值得補充的是,這個問題在今日已大幅緩和:現代瀏覽器與伺服器普遍以 UTF-8 為預設,且 jQuery 1.5 之後的行為也有所調整。但如果你維護的是老系統,或專案仍須對接 GB2312 的舊介面,理解這層編碼鏈路依然很有幫助。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved