SpringBoot Controller中Map类型Request Param始终为null问题求助

我之前也踩过一模一样的坑！你现在的问题核心在于Spring Boot对Map类型@RequestParam的绑定逻辑和你预期的不一样——Map默认是用来接收「不同参数名对应单个值」的键值对，而你的请求是同一个参数名（filter[]）传了多个值，这种场景下Map没法直接绑定，所以才会返回null。

下面给你几个实用的解决方案，按简便程度排序：

1. 直接用List<String>接收（最推荐） #

既然是多个同参数名的ID，直接用集合类型接收就对了，Spring会自动把filter[]的多个值绑定到List里：

@GetMapping("/news-items")
public ResponseEntity<?> getNewsItems(
        @RequestParam("filter[]") List<String> filterIds,
        @RequestParam int page,
        @RequestParam int per_page,
        @RequestParam String modelPath
) {
    // 这里filterIds就能拿到你传的两个UUID字符串了
    // 如果需要转成Map，你可以自己根据业务需求处理，比如：
    // Map<String, String> filterMap = filterIds.stream()
    //     .collect(Collectors.toMap(id -> id, id -> id));
    return ResponseEntity.ok(...);
}

如果愿意调整请求参数的格式，把filter[]改成filter（去掉方括号），连参数名都不用指定，Spring也能自动识别：

请求示例：http://localhost:8080/news-items?filter=09c731de-7ed8-385d-849c-f4d6535137ab&filter=dd1ba187-2df9-3985-ad1c-a4cde2dfe669&page=0&per_page=25

对应的Controller代码：

@GetMapping("/news-items")
public ResponseEntity<?> getNewsItems(
        @RequestParam List<String> filter,
        // 其他参数...
) {
    // 同样能拿到所有filter值
    return ResponseEntity.ok(...);
}

2. 用Map<String, List<String>>接收（兼容原请求格式） #

如果一定要用Map接收，可以把泛型改成Map<String, List<String>>，这样Spring会把同一个参数名的多个值封装成List作为value：

@GetMapping("/news-items")
public ResponseEntity<?> getNewsItems(
        @RequestParam Map<String, List<String>> filterMap,
        // 其他参数...
) {
    List<String> filterIds = filterMap.get("filter[]");
    // 拿到值之后就可以正常处理了
    return ResponseEntity.ok(...);
}

为什么原来的Map<String, String>会返回null？ #

再补充下原因帮你理解：当Spring处理@RequestParam Map<String, String>时，它会把每个唯一的参数名作为key，参数的单个值作为value。但你的请求里filter[]出现了两次，属于重复的参数名，Spring没法确定哪个值对应这个key，所以就直接返回null了。

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