Spring Controller中集合类型查询参数验证无法获取正确值

1. 调整请求参数格式 #

Spring MVC对GET请求中嵌套集合的参数绑定，需要遵循索引式命名规则。传递sort参数时，要按以下格式构造请求：

/api/projects?page=1&size=25&sort[0].sortBy=id&sort[0].sortDirection=asc&sort[1].sortBy=name&sort[1].sortDirection=desc

这种格式会让Spring正确识别每个PageSort对象的属性，并绑定到List<PageSort>中。

2. 验证默认值与参数覆盖逻辑 #

你的ProjectPage中sort字段设置了默认值：

private List<PageSort> sort = Arrays.asList(PageSort.builder().sortBy("id").sortDirection("asc").build());

如果请求中没有传递任何sort相关参数，会使用这个默认值；但如果传递了部分参数，必须保证参数格式正确，否则Spring无法覆盖默认集合，会导致绑定失败。

3. 可选：自定义参数绑定（支持简化格式） #

如果想支持更简洁的参数格式（比如用逗号分隔多组排序规则），可以自定义Converter或PropertyEditor：

示例：自定义Converter #

@Component
public class StringToPageSortListConverter implements Converter<String, List<PageSort>> {
    @Override
    public List<PageSort> convert(String source) {
        List<PageSort> sortList = new ArrayList<>();
        // 假设参数格式为 "id:asc,name:desc"
        String[] sortPairs = source.split(",");
        for (String pair : sortPairs) {
            String[] parts = pair.split(":");
            if (parts.length == 2) {
                sortList.add(PageSort.builder()
                        .sortBy(parts[0])
                        .sortDirection(parts[1])
                        .build());
            }
        }
        return sortList;
    }
}

然后在ProjectPage的sort字段上添加@RequestParam指定参数名：

@Valid
@RequestParam("sort")
private List<PageSort> sort = Arrays.asList(PageSort.builder().sortBy("id").sortDirection("asc").build());

此时请求可以用简化格式：

/api/projects?page=1&size=25&sort=id:asc,name:desc

4. 确保Spring配置支持嵌套绑定 #

Spring Boot默认已经启用了嵌套对象和集合的绑定功能，无需额外配置。如果是传统Spring MVC项目，需确保RequestMappingHandlerAdapter的配置中，ignoreUnknownFields保持默认的false值，并正确注册了BeanWrapper相关组件。

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