如何使用fetch与@RequestParam将列表绑定到Spring控制器

要解决这个问题，核心是让前端传递符合Spring解析规则的表单格式，后端只需要保持现有代码（或做极小调整）即可完成列表绑定。

问题根源 #

你当前的前端写法是把整个书籍列表编码成单个book参数的值（比如book=[book1,book2]），但Spring默认只会把这种格式当成一个字符串，无法自动解析为List<String>。

解决方案 #

1. 调整前端请求参数格式

在application/x-www-form-urlencoded格式中，传递列表的标准方式是重复参数名，比如book=book1&book=book2&addressid=123。这样Spring就能自动把所有同名的book参数收集成一个List。

修改前端构建msg的逻辑：

// 假设你的书籍列表是 params1 = ["bookId1", "bookId2", "bookId3"]
const bookParams = params1.map(bookId => `book=${encodeURIComponent(bookId)}`).join('&');
const addressParam = `addressid=${encodeURIComponent(你的地址ID变量)}`;
const msg = `${bookParams}&${addressParam}`;

// 后续的fetch请求保持不变
fetch(proxy+"/user/order/add",{
 method: 'post',
 credentials: 'include',
 headers: {
 'Accept': 'application/json',
 'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8'
 },
 body: msg,
})

2. 后端控制器无需额外修改

你的现有控制器代码完全兼容这种格式，Spring会自动将所有book参数值收集到List<String>中：

@PostMapping(value="/order/add")
@ResponseBody
public JSONObject addOrder(@RequestParam("book") List<String> books, @RequestParam("addressid") Integer addressid){ 
    // 直接使用books列表即可，比如遍历处理每本图书ID
    for(String bookId : books) {
        // 业务逻辑处理
    }
    // ... 返回结果
}

额外说明 #

• 如果你的Spring版本较低（比如Spring Boot 1.x），可以显式指定@RequestParam的required属性（如果允许空列表的话设为false）：

  @RequestParam(value = "book", required = false) List<String> books
  

• 不推荐把列表拼接成单个字符串再让后端分割（比如book=book1,book2），这种方式不符合HTTP表单规范，也增加后端的解析成本。

内容的提问来源于stack exchange，提问作者Jiansi W