萬盛學電腦網

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

AJAX 請求中文亂碼解決方案:雙重 encodeURI + 後端 UrlDecode

問題現象

jQuery AJAX GET 請求傳遞中文參數,伺服端接收到亂碼(如 %E6%B5%8B%E8%AF%95 未正確解碼)。

前端:雙重 encodeURI

$.ajax({
    type: 'POST',
    contentType: 'application/x-www-form-urlencoded; charset=utf-8',
    url: 'handler.ashx?Method=Update&folderName=' + encodeURI(encodeURI(folderName)),
    success: function(msg){ alert(msg); }
});
  • 第一次 encodeURI 將中文轉為 UTF-8 百分號編碼。
  • 第二次 encodeURI 將百分號 % 再編碼為 %25,防止瀏覽器/伺服器預設以其他編碼(如 GB2312)解碼第一層。

後端:對應雙重 UrlDecode

// C# (ASP.NET)
string folderName = Request["folderName"]; // 第一層解碼(自動)
string folderName2 = HttpUtility.UrlDecode(folderName); // 第二層手動解碼
// 此時 folderName2 為正確中文

根本原因

  • 瀏覽器發送請求時,URL 會依頁面編碼或系統預設編碼進行編碼。
  • 伺服端 Request 自動解碼一次,若前端預先編碼一次,則需手動再解碼一次。
  • 雙重編碼確保傳輸過程中不被錯誤解碼。

更佳現代做法

  1. POST + JSON:將資料放在 Request Body 以 JSON 傳送,避開 URL 編碼地獄。
    $.ajax({
        type: 'POST',
        contentType: 'application/json; charset=utf-8',
        data: JSON.stringify({folderName: folderName}),
        ...
    });
  2. 設定頁面與伺服器統一 UTF-8:
    • HTML:<meta charset="utf-8">
    • 伺服器回應 Header:Content-Type: text/html; charset=utf-8
    • Web.config:<globalization requestEncoding="utf-8" responseEncoding="utf-8" />
  3. 使用 encodeURIComponent:針對單一參數值編碼(編碼 & = 等保留字元),比 encodeURI 更安全。

完整修正範例

// 前端
var params = { folderName: folderName, custId: custId };
$.post('handler.ashx', params, function(res){ ... }); // jQuery 內建 encodeURIComponent

// 後端 (ASP.NET Core)
[HttpPost]
public IActionResult Update([FromForm] string folderName, [FromForm] int custId) {
    // 模型綁定自動處理 UTF-8 解碼
    return Ok(service.Update(folderName, custId));
}
copyright © 萬盛學電腦網 all rights reserved