做公告瀏覽功能時遇到一個惱人的現象:只要用 URL 傳的參數值裡含有 & 或空白,該變數的值就永遠顯示不出來。
URL 的 query string 以 & 作為參數分隔符號。當你寫出 page.jsp?para1=a&b,伺服器解析時會把它當成兩個參數:para1 = a,以及 b(沒有值)。para1 拿到的自然是 "a",後半段直接丟失——這不是 bug,而是 URL 規格的正常行為。
Java 端可以先編碼看看 & 會變成什麼:
String charEncode = java.net.URLEncoder.encode("&");
System.out.println("字符& 轉譯後的值為:" + charEncode); // 輸出:%26
於是有人得到結論:傳送前把 & 全部換成 %26。
var url = "page.jsp?para1=a&b"; // 錯誤 var url = "page.jsp?para1=a%26b"; // 勉強可用
這在只有 & 需要處理時確實有效,但遇到 =、?、#、空白、中文、+ 時又會出問題,等於要自己維護一張對照表。
encodeURIComponent() 會把 &、=、?、#、+、空白等所有會干擾解析的字元一併編碼,這才是 URL 參數該做的事:
var params = {
para1: 'a&b',
title: '公告 內容 & 說明',
q: '100=200'
};
var query = Object.keys(params)
.map(function (k) {
return encodeURIComponent(k) + '=' + encodeURIComponent(params[k]);
})
.join('&');
var url = 'page.jsp?' + query;
// page.jsp?para1=a%26b&title=...%26...&q=100%3D200
後端(Java 的 request.getParameter)會自動解回原值,不必做任何處理。
反向操作也不用手寫:
var search = new URLSearchParams(location.search);
console.log(search.get('para1')); // 自動解碼後的值
// 相容舊瀏覽器的手寫版
function getParam(name) {
var m = new RegExp('[?&]' + name + '=([^&]*)').exec(location.search);
return m ? decodeURIComponent(m[1].replace(/\+/g, ' ')) : '';
}
1. encodeURI 與 encodeURIComponent 不要混用。encodeURI 會保留 ;,/?:@&=+$# 這些字元不動,因此不能用來編碼參數值。參數值一律用 encodeURIComponent。
2. 空格的兩種編碼。表單傳統上用 + 代表空格(application/x-www-form-urlencoded),而 encodeURIComponent 會編成 %20。兩者在 query string 中大多相容,但解析時最好把 + 還原成空白,如上例所示。
3. 中文與特殊字元務必編碼。不編碼的中文在不同伺服器與代理的處理下可能變成亂碼,這是「本機測試正常、上線就出錯」的常見原因之一。
最後補一句:參數值若含敏感資訊,即使編碼過也仍會出現在伺服器 log、瀏覽器歷史與 Referer 標頭中,這類資料請改用 POST body 傳送。