萬盛學電腦網

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

解決 AJAX 傳輸含加號(+)導致後端接收錯誤的編碼問題

問題現象

在 AJAX 請求中,若參數值包含 + 號(如電影名稱「B+偵探」),直接傳遞會導致後端接收到的字串將 + 解析為空格,造成查詢失敗或連結錯誤。

根本原因

  • URL 編碼規範(RFC 3986)中,+ 在 application/x-www-form-urlencoded 內代表空格。
  • 瀏覽器在序列化表單或手動拼接 Query String 時,若未對 + 進行 %2B 編碼,伺服器會誤判為空格。

解決方案

1. 使用 encodeURIComponent(推薦)

const param = "B+偵探";
const encoded = encodeURIComponent(param); // "B%2B%E5%81%B5%E6%8E%A2"
// 發送時帶入 encoded 值

2. jQuery .param() 自動處理

$.ajax({
    url: "/api/search",
    data: { keyword: "B+偵探" }, // jQuery 內部會自動 encodeURIComponent
    // 或
    data: $.param({ keyword: "B+偵探" })
});

3. 後端解碼對應

  • Java: URLDecoder.decode(param, "UTF-8")
  • PHP: urldecode($param) 或自動由 $_GET/$_POST 處理
  • Node.js: querystring.parse 或 decodeURIComponent
  • Python: urllib.parse.unquote

完整前端範例

function searchMovie(name) {
    const safeName = encodeURIComponent(name);
    $.get(`/api/movie?name=${safeName}`, function(res) {
        console.log(res);
    });
}

// 或使用 data 物件讓 jQuery 自動編碼
function searchMovie2(name) {
    $.ajax({
        url: "/api/movie",
        data: { name: name }, // 內部自動 encode
        success: function(res) { console.log(res); }
    });
}

其他需注意的特殊字元

字元編碼後備註
空格%20或 +(僅限 form-urlencoded)
#%23片段識別符
&%26參數分隔符
=%3D鍵值分隔符
?%3F查詢字串起始
%%25編碼標記本身

最佳實踐總結

  1. 永遠使用 encodeURIComponent 或框架內建序列化方法,切勿手動拼接 URL。
  2. 前後端統一採用 UTF-8 編碼。
  3. 若為 GET 請求且參數極長,考慮改用 POST + JSON Body,避免 URL 長度限制。
copyright © 萬盛學電腦網 all rights reserved