前端需要向後端傳遞「同名多值」(如多個 ID、勾選的標籤)時,常見三種方式:逗號拼接字符串、**同名參數重複**、**JSON 序列化**。本文對比優缺點,給出各語言後端接收示例與工程化建議。
| 方式 | 前端發送示例 | 後端接收 | 優點 | 缺點 |
|---|---|---|---|---|
| 逗號拼接字符串 | ids=1,2,3 | String ids = req.getParameter("ids"); String[] arr = ids.split(","); | 簡單、URL 短、所有語言通用 | 值含逗號需轉義、類型擴展性差 |
| 同名參數重複 | ids=1&ids=2&ids=3 | Java: req.getParameterValues("ids")PHP: $_GET['ids'] (需 ids[])Node: req.query.ids (陣列) | 標準 Web 規範、無需手動拼接/分割、原生支持數組 | URL 較長、部分舊框架不支持 |
| JSON 序列化 | data=%5B1,2,3%5D (POST Body) | 統一反序列化為 List/Array | 支持嵌套對象、類型豐富、體積大時不受 URL 長度限制 | 需 POST、需設置 Content-Type、GET 不適用 |
/**
* 將數組轉換為三種格式之一
* @param {Array} arr - 值數組
* @param {string} mode - 'comma' | 'repeat' | 'json'
* @param {string} key - 參數名
* @returns {string|Object} 查詢字符串或 Body 對象
*/
function encodeArrayParam(arr, key, mode = 'repeat') {
if (!Array.isArray(arr) || arr.length === 0) return mode === 'json' ? {} : '';
const encoded = arr.map(v => encodeURIComponent(String(v)));
switch (mode) {
case 'comma':
return `${key}=${encoded.join(',')}`;
case 'repeat':
return encoded.map(v => `${key}=${v}`).join('&');
case 'json':
return {[key]: arr}; // 配合 $.ajax / fetch 發送 JSON Body
default:
throw new Error('Unknown mode');
}
}
// 使用示例
const ids = [102, 103, 104];
// 1. GET + 逗號拼接
location.href = `/test.jsp?${encodeArrayParam(ids, 'ids', 'comma')}`;
// /test.jsp?ids=102,103,104
// 2. GET + 同名重複 (推薦)
location.href = `/test.jsp?${encodeArrayParam(ids, 'ids', 'repeat')}`;
// /test.jsp?ids=102&ids=103&ids=104
// 3. POST + JSON Body (推薦複雜數據)
fetch('/api/items', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify(encodeArrayParam(ids, 'ids', 'json'))
});
// 方式 1: 逗號字符串
@GetMapping("/test")
public void test1(@RequestParam String ids) {
String[] arr = ids.split(","); // 手動分割
}
// 方式 2: 同名參數 (推薦)
@GetMapping("/test")
public void test2(@RequestParam List ids) { // 自動綁定 List
// ids = [102, 103, 104]
}
// 方式 3: JSON Body
@PostMapping("/api/items")
public void test3(@RequestBody IdsDTO dto) {
// dto.getIds() -> List
}
static class IdsDTO { private List ids; /* getter/setter */ }
// 方式 1: 逗號字符串
$ids = explode(',', $_GET['ids'] ?? '');
// 方式 2: 同名參數 (需前端傳 ids[]=1&ids[]=2)
$ids = $_GET['ids'] ?? []; // 自動是數組
// 方式 3: JSON Body
$data = json_decode(file_get_contents('php://input'), true);
$ids = $data['ids'] ?? [];
// 方式 1 & 2: query parser 自動合併同名參數為數組
app.get('/test', (req, res) => {
const ids = req.query.ids; // 已是數組 ['102','103','104'] 或字符串 '102' (單值)
const arr = Array.isArray(ids) ? ids : [ids];
});
// 方式 3: JSON Body
app.post('/api/items', express.json(), (req, res) => {
const ids = req.body.ids; // 直接是數組
});
# Flask
ids = request.args.getlist('ids') # 同名參數自動獲取列表
# JSON
ids = request.get_json().get('ids', [])
URLSearchParams 或封裝函數自動處理編碼。ids、tags、statuses」減少溝通成本。type ArrayParamMode = 'comma' | 'repeat' | 'json';
function encodeArrayParam(arr: T[], key: string, mode: ArrayParamMode): string | Record;
url = 'test.jsp?arr=' + arr 直接拼接數組 → JS 隱式調用 toString() 得到 "1,2,3",**但包含特殊字符時會亂碼**,必須 encodeURIComponent。request.getParameter("ids") 接收同名參數 → **只能拿到第一個值**,必須用 getParameterValues 或框架自動綁定 List。現代 Web 開發中,**GET 用同名參數(ids=1&ids=2),POST 用 JSON Body** 是最標準、最省心的組合。封裝統一工具函數,前後端約定好參數名與模式,即可杜絕「數組傳參亂碼/丟失/類型錯誤」等低級問題。