萬盛學電腦網

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

JavaScript 向後端傳遞數組參數:三種方式對比與最佳實踐

前端需要向後端傳遞「同名多值」(如多個 ID、勾選的標籤)時,常見三種方式:逗號拼接字符串、**同名參數重複**、**JSON 序列化**。本文對比優缺點,給出各語言後端接收示例與工程化建議。

方式對比總覽

方式前端發送示例後端接收優點缺點
逗號拼接字符串ids=1,2,3String ids = req.getParameter("ids"); String[] arr = ids.split(",");簡單、URL 短、所有語言通用值含逗號需轉義、類型擴展性差
同名參數重複ids=1&ids=2&ids=3Java: 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'))
});

後端接收示例

Java (Spring MVC)

// 方式 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 */ }

PHP


// 方式 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'] ?? [];

Node.js (Express)

// 方式 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; // 直接是數組
});

Python (Flask/Django)

# Flask
ids = request.args.getlist('ids')  # 同名參數自動獲取列表
# JSON
ids = request.get_json().get('ids', [])

工程化建議

  1. GET 請求優先用「同名參數重複」:符合 HTTP 標準、後端框架原生支持、無需手動拼接分割。
  2. POST 請求優先用 JSON Body:支持嵌套結構、類型安全、無 URL 長度限制。
  3. 避免手動拼接 URL:使用 URLSearchParams 或封裝函數自動處理編碼。
  4. 統一參數名約定:團隊約定「數組參數名用複數形式 ids、tags、statuses」減少溝通成本。
  5. TypeScript 類型定義:
    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。
  • ❌ GET 請求發送 JSON Body → 違反 HTTP 語義,部分代理/防火牆會丟棄 Body。
  • ❌ 後端用 request.getParameter("ids") 接收同名參數 → **只能拿到第一個值**,必須用 getParameterValues 或框架自動綁定 List。
  • ✅ 文件上傳/大數據必須用 POST + FormData/JSON,勿塞入 URL。

總結

現代 Web 開發中,**GET 用同名參數(ids=1&ids=2),POST 用 JSON Body** 是最標準、最省心的組合。封裝統一工具函數,前後端約定好參數名與模式,即可杜絕「數組傳參亂碼/丟失/類型錯誤」等低級問題。

copyright © 萬盛學電腦網 all rights reserved