一個看似無關痛癢的「+」號,足以讓整條 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() 保留 ; , / ? : @ & = + $ # 等語法字元不動,適合編碼整條 URL;encodeURIComponent() 會把這些一併編碼,適合編碼單一參數值。傳值時後者是正確選擇——用錯這一個,加號問題就會重演。
另外提醒:encodeURIComponent 不會編碼 ' ( ) * ! - _ . ~,其中單引號在部分情境仍有風險。若內容要放進 HTML 屬性或 SQL,該做的輸出編碼與參數化查詢一個都不能省。