关于Spring MVC中传递数组参数的详细说明，包括如何通过逗号分隔的字符串自动转换为数组，以及具体的代码示例和总结表格

以下是关于Spring MVC中传递数组参数的详细说明，包括如何通过逗号分隔的字符串自动转换为数组，以及具体的代码示例和总结表格：

1. 核心机制

Spring MVC支持直接通过逗号分隔的字符串将请求参数自动转换为数组（String[]、int[]等）。例如：

请求参数：items=1,2,3
后端接收：@RequestParam String[] items 或 @RequestParam int[] numbers

2. 代码示例

2.1 基础用法：字符串数组

@RestController
public class ArrayController {// 接收逗号分隔的字符串数组@GetMapping("/items")public String getItems(@RequestParam("items") String[] items) {return "Received items: " + String.join(", ", items);}
}

测试请求：
GET /items?items=apple,banana,orange
返回：Received items: apple, banana, orange

2.2 整数数组

// 接收逗号分隔的整数数组
@GetMapping("/numbers")
public String getNumbers(@RequestParam("numbers") int[] numbers) {return "Sum: " + Arrays.stream(numbers).sum();
}

测试请求：
GET /numbers?numbers=10,20,30
返回：Sum: 60

2.3 可选参数与默认值

// 可选参数+默认值（数组）
@GetMapping("/optional")
public String getOptional(@RequestParam(name = "tags", required = false, defaultValue = "default1,default2") String[] tags
) {return "Tags: " + String.join(", ", tags);
}

测试场景：

未传参数：GET /optional → 返回 Tags: default1, default2
传参数：GET /optional?tags=java,spring → 返回 Tags: java, spring

2.4 多参数绑定

@GetMapping("/combined")
public String getCombined(@RequestParam("ids") int[] ids,@RequestParam("names") String[] names
) {return "IDs: " + Arrays.toString(ids) + ", Names: " + String.join(", ", names);
}

测试请求：
GET /combined?ids=1,2&names=Alice,Bob
返回：IDs: [1, 2], Names: Alice, Bob

3. 关键点说明

自动转换规则：
- Spring默认将逗号分隔的字符串转换为数组（String[]、int[]等）。
- 若参数值不含逗号，则转换为单元素数组。
类型支持：
- 基本类型数组：如int[]、double[]。
- 包装类型数组：如Integer[]、List<String>（需显式转换）。
异常处理：
- 类型转换失败（如int[]接收a,b）：抛出TypeMismatchException。
- 参数缺失且required = true：抛出MissingServletRequestParameterException。
多值参数：
- 可通过重复参数名传递数组（如?name=Alice&name=Bob），效果等同于逗号分隔。

4. 常见问题与解决

问题	原因与解决方案
数组元素类型不匹配（如`int[]`接收字符串）	确保参数值可转换为目标类型（如`numbers=1,a`会导致`NumberFormatException`）。
参数名不匹配（如`items`与`item`）	使用`@RequestParam("items")`显式指定前端参数名。
需要自定义分隔符（非逗号）	通过`@RequestParam`结合自定义`Converter`实现，或手动拆分字符串。

5. 总结表格

场景	@RequestParam配置	示例	说明
字符串数组	`@RequestParam("items") String[] items`	`GET /items?items=apple,banana` → `[apple, banana]`	默认逗号分隔，支持`required`和`defaultValue`。
整数数组	`@RequestParam("numbers") int[] numbers`	`GET /numbers?numbers=10,20` → `[10, 20]`	类型转换失败会抛出异常。
可选数组+默认值	`@RequestParam(defaultValue="a,b") String[] opts`	未传参数 → `["a", "b"]`	`required = false`允许参数缺失。
多参数绑定	`@RequestParam String[] a, @RequestParam int[] b`	`GET ?a=x,y&b=1,2` → `[x,y]`和`[1,2]`	支持多个数组参数。

6. 完整代码示例

ArrayController.java

import org.springframework.web.bind.annotation.*;import java.util.Arrays;@RestController
public class ArrayController {// 1. 基础字符串数组@GetMapping("/items")public String getItems(@RequestParam("items") String[] items) {return "Items received: " + String.join(", ", items);}// 2. 整数数组求和@GetMapping("/sum")public String sumNumbers(@RequestParam("numbers") int[] numbers) {return "Sum: " + Arrays.stream(numbers).sum();}// 3. 可选参数+默认值@GetMapping("/tags")public String getTags(@RequestParam(name = "tags", required = false, defaultValue = "default")String[] tags) {return "Tags: " + String.join(", ", tags);}// 4. 多参数绑定@GetMapping("/combined")public String getCombined(@RequestParam("ids") int[] ids,@RequestParam("names") String[] names) {return "IDs: " + Arrays.toString(ids) + ", Names: " + String.join(", ", names);}
}

测试请求

基础字符串数组：

GET /items?items=apple,banana → 返回 "Items received: apple, banana"

整数数组求和：

GET /sum?numbers=10,20,30 → 返回 "Sum: 60"

可选参数+默认值：

GET /tags → 返回 "Tags: default"
GET /tags?tags=java,python → 返回 "Tags: java, python"

多参数绑定：

GET /combined?ids=100,200&names=Alice,Bob → 返回 "IDs: [100, 200], Names: Alice, Bob"

7. 注意事项

分隔符限制：默认仅支持逗号分隔，若需其他分隔符（如|），需手动处理：
```
@RequestParam("items") String itemsStr,
String[] items = itemsStr.split("\\|");
```
复杂类型：若需传递对象数组，需使用@RequestBody或自定义转换器。
安全性：避免直接传递大数组导致性能问题。