DIV CSS 佈局教程網

加號「+」讓 AJAX 傳值出錯:原因與轉義解法
編輯:JavaScript綜合知識     

一個看似無關痛癢的「+」號,足以讓整條 AJAX 鏈路中斷。本文記錄一次真實排查過程,並說明背後的原理與正確解法。

問題現場

使用者回報某幾部電影無法播放,其他資源卻正常。名稱在程式裡明明已經做過字元轉換,怎麼想都想不通。反覆除錯後才發現:轉碼後的 URL 裡存在一個 "+",把它刪掉之後連結就通了。

為什麼加號會出問題

依 application/x-www-form-urlencoded 規範,查詢字串中的 + 代表半形空格。所以後端收到的並不是加號,而是一個空白,比對自然失敗。這跟字元編碼無關,是 URL 傳輸層的語法衝突。

另一個常見狀況是:+ 出現在路徑(path)而非查詢字串中,某些伺服器或代理會直接判定為非法字元而拒絕,形成連線層級的錯誤。

正確解法

用 encodeURIComponent() 編碼,它會把 + 轉成 %2B,後端解碼後就能拿回真正的加號:

// 錯誤:字串直接拼接
var url = '/api/movie?name=' + name;

// 正確
var url = '/api/movie?name=' + encodeURIComponent(name);

若用 jQuery,把資料放進 data 物件而非手動拼字串,它會自動幫你編碼:

$.ajax({ url: '/api/movie', data: { name: name } });

用 fetch 時則可改用 URLSearchParams:

const qs = new URLSearchParams({ name }).toString();
fetch('/api/movie?' + qs);

該用 encodeURI 還是 encodeURIComponent?

encodeURI() 保留 ; , / ? : @ & = + $ # 等語法字元不動,適合編碼整條 URL;encodeURIComponent() 會把這些一併編碼,適合編碼單一參數值。傳值時後者是正確選擇——用錯這一個,加號問題就會重演。

另外提醒:encodeURIComponent 不會編碼 ' ( ) * ! - _ . ~,其中單引號在部分情境仍有風險。若內容要放進 HTML 屬性或 SQL,該做的輸出編碼與參數化查詢一個都不能省。

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