URLEncoder/URLDecoder 正確處理 URL 參數特殊字元：Base64 編碼傳輸實戰指南

URLEncoder/URLDecoder 正確處理 URL 參數特殊字元：Base64 編碼傳輸實戰指南

URL 參數值若包含 / + = & % # 等特殊字元（如 Base64 密文），直接拼接會導致參數截斷或錯誤。本文詳細說明編碼/解碼正確姿勢與常見坑點。

問題場景

String cipher = "za4T8MHB/6mhmYgXB7IntyyOUL7Cl++0jv5rFxAIFVji8GDrcf+k8g==";
// 直接拼接
String url = "https://api.example.com?param=" + cipher;
// 伺服端接收到的 param 變為：
// "za4T8MHB/6mhmYgXB7IntyyOUL7Cl  0jv5rFxAIFVji8GDrcf k8g=="
// + 被解析為空格，/ 被誤判為路徑分隔

正確編碼流程

1. 客戶端： 僅對參數值進行 URLEncoder.encode(value, "UTF-8")
2. 伺服端： 獲取參數後 URLDecoder.decode(param, "UTF-8")

// 客戶端
String url = "https://api.example.com?param=" + URLEncoder.encode(cipher, "UTF-8");

// 伺服端
String param = request.getParameter("param");
String original = URLDecoder.decode(param, "UTF-8");

核心原則：只編碼值，不編碼整個 URL

// ✅ 正確
String q = "random word 攏500 bank $";
String url = "https://example.com/query?q=" + URLEncoder.encode(q, "UTF-8");

// ❌ 錯誤：編碼整個 URL，破壞 ? & = 結構
String bad = URLEncoder.encode("https://example.com/query?q=value", "UTF-8");

// ❌ 錯誤：編碼 param=value 整體
String bad2 = URLEncoder.encode("param=value", "UTF-8");

原因： & 分隔參數，= 分隔鍵值，編碼後伺服端無法解析。

JavaScript 對應函數

前端傳參請使用 encodeURIComponent(value)，後端 Java URLDecoder.decode 完美對應。

進階：Spring MVC 自動解碼

Spring MVC @RequestParam、@PathVariable 會自動解碼，無需手動 decode。若雙重解碼會導致 % 變為 %25 等錯誤。