萬盛學電腦網

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

JavaScript 處理 URL 參數特殊符號(&、空格、中文)完整指南

URL 參數傳遞時,`&`、`=`、`?`、`#`、空格、中文等特殊字元若不正確編碼,會導致參數截斷、解析錯誤或安全漏洞。本文詳細說明前後端編碼/解碼策略與最佳實踐。

核心問題:`&` 會被誤判為參數分隔符

// 錯誤範例:cn 參數值包含 "&"
const url = 'groupsDetailServlet?groupType=A&cn=AT&T';
// 實際解析:groupType=A, cn=AT, T=undefined

前端編碼方案

1. `encodeURIComponent()` —— 標準、推薦

function buildUrl(base, params) {
  const search = new URLSearchParams();
  Object.entries(params).forEach(([k, v]) => search.append(k, v));
  return `${base}?${search.toString()}`;
}

// 使用
const url = buildUrl('groupsDetailServlet', {
  groupTypeForDetail: 'A',
  cn: 'AT&T'  // 自動編碼為 AT%26T
});
location.href = url; // groupsDetailServlet?groupTypeForDetail=A&cn=AT%26T

優點: 符合 RFC 3986、處理所有保留字元、支援 Unicode、現代瀏覽器原生支援。

2. `encodeURI()` —— 僅編碼整個 URL 的非保留字元

const url = 'https://example.com/search?q=hello world';
encodeURI(url); // "https://example.com/search?q=hello%20world"
// 注意:不編碼 & = ? # 等保留字元,不適合編碼單一參數值

3. `escape()` —— **已棄用**,勿使用

不編碼 `+`、`@`、`*`、`/` 等,編碼方式非標準(`%uXXXX`),現代環境請改用 `encodeURIComponent`。

後端編碼方案

Java 範例

// 編碼
String encoded = URLEncoder.encode(cn, StandardCharsets.UTF_8); 
// AT&T → AT%26T

// 解碼
String decoded = URLDecoder.decode(encoded, StandardCharsets.UTF_8);

C# 範例

// 編碼
string encoded = Uri.EscapeDataString(cn); // 或 HttpUtility.UrlEncode

// 解碼
string decoded = Uri.UnescapeDataString(encoded);

Node.js 範例

const querystring = require('querystring');
const encoded = querystring.escape('AT&T'); // 'AT%26T'
const decoded = querystring.unescape(encoded);

自訂編碼方案(舊系統相容)

若舊系統無法使用標準編碼,可約定替代字元(如 `@` 代替 `&`),但**強烈不建議**新專案採用:

// 編碼
function customEncode(str) {
  return str.replace(/&/g, '@@'); // 雙 @ 避免衝突
}
// 解碼
function customDecode(str) {
  return str.replace(/@@/g, '&');
}

完整 URL 建構與解析最佳實踐

前端:使用 `URL` + `URLSearchParams` (現代標準)

const apiBase = 'https://api.example.com';
const url = new URL('/groups/detail', apiBase);
url.searchParams.set('groupType', 'A');
url.searchParams.set('cn', 'AT&T'); // 自動編碼
console.log(url.href); // https://api.example.com/groups/detail?groupType=A&cn=AT%26T

// 解析現有 URL
const parsed = new URL(window.location.href);
const cn = parsed.searchParams.get('cn'); // 自動解碼 → "AT&T"

後端:框架內建模型綁定自動處理

// ASP.NET Core
[HttpGet("groups/detail")]
public IActionResult Detail(string groupType, string cn) {
  // cn 已自動解碼為 "AT&T"
}

// Spring Boot
@GetMapping("/groups/detail")
public ResponseEntity detail(@RequestParam String groupType, @RequestParam String cn) {
  // cn 已自動解碼
}

// Express.js
app.get('/groups/detail', (req, res) => {
  const { groupType, cn } = req.query; // 已自動解碼
});

常見編碼陷阱對照表

情境錯誤做法正確做法
拼接查詢字串`'?a=' + val``new URLSearchParams({a: val}).toString()`
已編碼字串再編碼`encodeURIComponent(encodeURIComponent(val))`僅編碼一次
表單提交手動拼接`
` 原生提交或 `new FormData(form)`
中文參數依賴瀏覽器預設編碼明確指定 UTF-8,使用 `encodeURIComponent`
雙重編碼前端編碼 + 後端再編碼約定單邊負責,通常前端編碼、後端解碼

總結建議

  1. **前端統一使用 `URLSearchParams` / `encodeURIComponent`**,勿手動拼接。
  2. **後端依賴框架自動解碼**,勿手動 `URLDecoder`。
  3. **全鏈路 UTF-8**:HTML ``、JS 檔案 UTF-8、資料庫 UTF-8、伺服器回應 `Content-Type: application/json; charset=utf-8`。
  4. **測試案例**:包含 `&`、`=`、`?`、`#`、` `、`中文`、`emoji` 😀 的參數值。

標準化編碼/解碼流程,能從根源杜絕參數截斷、亂碼、注入等經典 Bug。

copyright © 萬盛學電腦網 all rights reserved