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

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

1. 核心机制

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

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

2. 代码示例

2.1 基础用法：字符串数组

java 复制代码

@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 整数数组

java 复制代码

// 接收逗号分隔的整数数组
@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 可选参数与默认值

java 复制代码

// 可选参数+默认值（数组）
@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 多参数绑定

java 复制代码

@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

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. 注意事项

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

通过上述方法，Spring MVC可轻松处理数组参数，适用于过滤、多选等场景。