萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery AJAX 中文亂碼終極解決:GET/POST 統一編碼、Tomcat 設定、Filter、jQuery 核心修改

亂碼根因分析

中文在傳輸鏈路中經歷:頁面編碼 → JS 編碼 → HTTP 傳輸 → 伺服器解碼 → 伺服器處理 → 回應編碼 → 瀏覽器解碼。任一環節不一致即產生亂碼。

完整解決方案清單 (按優先序)

1. 頁面編碼統一 UTF-8 (基礎)

<meta charset="utf-8">
<!-- 或舊寫法 -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

所有 .jsp/.html/.js 檔案儲存為 UTF-8 無 BOM。

2. Servlet 回應編碼 (關鍵:在 getWriter() 前)

response.setContentType("text/html;charset=UTF-8"); // 或 application/json;charset=UTF-8
response.setCharacterEncoding("UTF-8"); // 同效
PrintWriter out = response.getWriter(); // 之後寫入自動用 UTF-8

3. Tomcat 連接器 URIEncoding (解決 GET 參數亂碼)

<!-- conf/server.xml -->
<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           URIEncoding="UTF-8" />

重啟 Tomcat 生效。此設定讓 Tomcat 用 UTF-8 解碼 URL 查詢字串,GET 亂碼一勞永逸。

4. 編碼過濾器 (強制請求/回應編碼)

@WebFilter("/*")
public class EncodingFilter implements Filter {
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        req.setCharacterEncoding("UTF-8");
        resp.setCharacterEncoding("UTF-8");
        resp.setContentType("text/html;charset=UTF-8");
        chain.doFilter(req, resp);
    }
}

在 web.xml 註冊或 @WebFilter 自動掃描。確保所有請求/回應編碼一致。

5. jQuery AJAX 發送編碼 (POST 通常無問題,GET 需注意)

jQuery 預設 contentType: "application/x-www-form-urlencoded; charset=UTF-8",POST 會正確發送 UTF-8。

GET 請求參數編碼:

// jQuery 內部會自動 encodeURIComponent,但舊版可能需手動雙重編碼
data: { userName: $('#userName').val() } // 直接傳物件,jQuery 自動編碼
// 切勿手動 encodeURI/encodeURIComponent 導致雙重編碼

6. 終極大招:修改 jQuery 核心 source (不推薦,僅救急)

在 jquery-x.x.x.js 中找到 contentType: "application/x-www-form-urlencoded" 改為:

contentType: "application/x-www-form-urlencoded;charset=UTF-8"

這確保所有 AJAX 請求標頭明確帶 charset。缺點:升級 jQuery 會遺失,建議改用 $.ajaxSetup({contentType: ...}) 全域設定。

驗證步驟

  1. 瀏覽器 Network 面板檢查 Request Headers:Content-Type: application/x-www-form-urlencoded; charset=UTF-8
  2. Response Headers:Content-Type: text/html;charset=UTF-8 或 application/json;charset=UTF-8
  3. Servlet 端 System.out.println(param) 觀察控制台輸出。
  4. 資料庫儲存後讀出檢查。

前後端分離架構下的最佳實踐

  • 前端:統一 fetch/axios,預設 JSON 格式 Content-Type: application/json;charset=UTF-8。
  • 後端:Spring Boot @RestController 自動處理 UTF-8 JSON 序列化/反序列化。
  • 資料庫:表/欄位 CHARSET=utf8mb4、連線字串 characterEncoding=utf8。
  • Nginx/反向代理:charset utf-8;。

總結

亂碼核心在於「編碼不一致」。依序落實:檔案存儲 UTF-8 → 頁面 meta charset → Tomcat URIEncoding → Filter 強制編碼 → Servlet 回應設定 → AJAX contentType。現代前後端分離採用 JSON + UTF-8 全鏈路,徹底杜絕亂碼。

copyright © 萬盛學電腦網 all rights reserved