DIV CSS 佈局教程網

jQuery AJAX 中文亂碼全攻略:GET 與 POST 的成因與解法
編輯:JQuery特效代碼     

用 jQuery 發 AJAX 請求時,中文傳到後端變成問號或亂碼,是每個人都會撞上一次的經典問題。它不是 jQuery 的錯,而是編碼不一致:瀏覽器用一種編碼送出位元組,伺服器用另一種編碼解讀,同一串位元組被賦予了錯誤的意義。

先建立正確的心智模型

文字在網路上傳遞時,本質上是一串位元組。編碼就是「位元組 ↔ 字元」的對照表。只要送出的編碼與接收端假設的編碼不同,中文一定亂。所以解法永遠只有一個方向:讓兩端對齊。以下用一個使用者名重複檢查的小專案走一遍。

步驟一:建立專案

新建 Web 專案(此例預設 GBK),在 WebRoot 下建立 js 目錄並放入 jquery-1.4.4.js。頁面與伺服器使用的編碼務必記錄下來,後面每一步都要對照。

步驟二:後端 Servlet

package servlet;

import java.io.IOException;
import java.io.PrintWriter;
import java.net.URLDecoder;
import javax.servlet.ServletException;
import javax.servlet.http.*;

public class Vali extends HttpServlet {
    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        // POST:先解碼再取值
        String userName = URLDecoder.decode(request.getParameter("userName"), "utf-8");
        System.out.println(userName);

        // 設定回應編碼
        response.setContentType("text/html;charset=utf-8");
        PrintWriter pw = response.getWriter();

        if ("張三".equals(userName)) {
            pw.println("錯誤");
        } else {
            pw.println("正確");
        }
    }
}

四個必須注意的點

一、URLDecoder.decode(..., "utf-8") 把前端編碼而來的字串還原成正確文字,這是 POST 的關鍵。

二、response.setContentType("text/html;charset=utf-8") 決定回應怎麼被瀏覽器解讀,少了它就會換成回程亂碼。

三、這行必須寫在取得 getWriter() 之前。一旦呼叫了 getWriter(),回應的編碼就被鎖定,之後再設定完全無效。這是最高頻的踩坑點。

四、上面的解碼方式只適用 POST。若前端用 GET,參數是走網址傳的,解讀方式完全不同:

request.setCharacterEncoding("utf-8");
String userName = request.getParameter("userName");
userName = new String(userName.getBytes("iso-8859-1"), "utf-8");

這裡 iso-8859-1 是 Servlet 容器解析查詢字串時的預設編碼,先取回原始位元組、再用 utf-8 重新解讀,是 Tomcat 未設定 URIEncoding 時的補救寫法。根本解法是設定容器的 URIEncoding,見文末。

步驟三:前端頁面

<%@ page language="java" pageEncoding="utf-8"%>
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <script src="js/jquery-1.4.4.js"></script>
  <script type="text/javascript">
  function vali(){
      $.ajax({
          type: "POST",
          url:  "/jQuery_Ajax/Vali",
          // 注意 encodeURI 用了兩層,配合後端的 URLDecoder 解一層
          data: encodeURI(encodeURI("userName=" + $(":text").val())),
          success: function(data){
              $("span").text(data);
          }
      });
  }
  </script>
</head>
<body>
  用戶名:<input type="text" name="userName" onblur="vali();" /><span></span><br/>
  密碼:<input type="password" name="password" />
</body>
</html>

若改用 GET,data 只需編碼一層:

function vali(){
    $.ajax({
        type: "GET",
        url:  "/jQuery_Ajax/Vali",
        data: encodeURI("userName=" + $(":text").val()),
        success: function(data){ $("span").text(data); }
    });
}

關於 encodeURI 的層數:編碼一次、解碼一次才對稱。原範例前端編兩層、後端只解一層,這種不對稱的寫法能跑是因為湊巧抵銷了某些中介層的行為,並不可靠。建議統一成「前端編一層、後端解一層」,或乾脆用 encodeURIComponent 對單一參數值編碼,語意更明確。

步驟四:web.xml 映射

<servlet>
  <servlet-name>Vali</servlet-name>
  <servlet-class>servlet.Vali</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>Vali</servlet-name>
  <url-pattern>/Vali</url-pattern>
</servlet-mapping>

如果以上都對了還是亂:七個檢查點

亂碼的來源可能散落在整條鏈路上,逐項排查比盲目嘗試有效:

1. 頁面編碼——確認 <meta http-equiv="content-type" content="text/html;charset=utf-8"> 存在,且檔案本身的實際編碼與之一致(用記事本另存的檔案常常名不副實)。

2. Servlet 回應編碼——在 doPost/doGet 裡加上 response.setContentType("text/xml;charset=utf-8"),並記得它要在 getWriter() 之前。

3. Tomcat 連接器——編輯 TOMCAT_HOME/conf/server.xml,為 Connector 加上 URIEncoding="utf-8":

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
           redirectPort="8443" URIEncoding="utf-8" />

4. 全域編碼過濾器——在專案中新增 filter,於 doFilter 裡對 request 與 response 都設定 utf-8。這是 Java Web 專案最一勞永逸的做法,也可以直接用 Spring 的 CharacterEncodingFilter。

5. 比對不同瀏覽器的請求標頭——用開發者工具看 IE 送出的 contentType 是 application/x-www-form-urlencoded,而 Firefox 送的是 application/x-www-form-urlencoded;charset=UTF-8。差異出現在這裡,就代表 IE 沒有宣告自己的編碼。

6. 必要時修改 jQuery 的預設 contentType——舊版 jQuery 在 ajaxSetup 中寫死了 contentType: "application/x-www-form-urlencoded",可以在自己的呼叫裡覆寫它,而不需要去改 jquery.js 原始檔(改原始檔會在下次升版時全部消失,是很糟的習慣):

$.ajax({
    url: "/jQuery_Ajax/Vali",
    type: "POST",
    contentType: "application/x-www-form-urlencoded;charset=UTF-8",
    data: { userName: $("#userName").val() },
    success: function(data){ $("span").text(data); }
});

根本解法優先

與其逐個手動 URLDecoder.decode,更好的策略是在專案入口統一處理:設定好 filter、設定好 Tomcat 的 URIEncoding、統一專案與資料庫都用 UTF-8。這樣業務程式碼裡就不必再想編碼的事。逐頁補救的寫法短期看似有效,專案一大就會變成難以追查的地雷區。

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