搞定Spring Boot GET传列表：3种方法解决复杂对象绑定

2025-04-09 22:52:30

Spring Boot GET 请求中传递复杂对象列表：踩坑与解决方案

写后端接口时，经常会遇到需要根据多种条件进行筛选查询的场景。一个常见的设计是在 GET 请求中接收一个过滤器列表，每个过滤器包含字段名、操作符和值。听起来很简单？但当你真正在 Spring Boot 中尝试用 List<YourComplexObject> 直接接收参数时，可能会遇到一些意想不到的麻烦。

比如下面这段看起来很直观的代码：

@GetMapping("/departments")
public Page<Department> search(Pageable pageable, List<@Valid FilterCriterion> filters) {
    // ... 具体的查询逻辑，这里为了演示省略
    System.out.println("接收到的 Pageable: " + pageable);
    System.out.println("接收到的 Filters: " + filters);
    return Page.empty(); // 仅作示例返回
}

// FilterCriterion 定义
public class FilterCriterion {
    @NotBlank @Size(min = 1, max = 255)
    private String column;

    @NotNull
    private FilterOperation operation;

    @Size(max = 255)
    private String value;

    // Getters, Setters, 无参构造, 全参构造...
    // ... 省略 стандартные методы ...

    // 为了方便调试，添加 toString 方法
    @Override
    public String toString() {
        return "FilterCriterion{" +
               "column='" + column + '\'' +
               ", operation=" + operation +
               ", value='" + value + '\'' +
               '}';
    }
}

// FilterOperation 枚举
public enum FilterOperation {
    EQUALS, NOT_EQUALS, CONTAINS, LT, LTE, GT, GTE
}

你兴冲冲地构造了一个请求 URL，想传入多个过滤条件：

http://localhost:8080/departments?page=0&size=10&sort=name,asc&filters[0].column=name&filters[0].operation=EQUALS&filters[0].value=foo&filters[1].column=location&filters[1].operation=CONTAINS&filters[1].value=bar

结果呢？啪，一个异常甩脸上：

java.lang.IllegalStateException: No primary or single unique constructor found for interface java.util.List

不死心，想着 List 是个接口，Spring 可能不知道该实例化哪个具体的 List 实现。于是把参数类型改成 ArrayList<@Valid FilterCriterion>：

@GetMapping("/departments")
public Page<Department> search(Pageable pageable, ArrayList<@Valid FilterCriterion> filters) {
    // ...
    System.out.println("接收到的 Pageable: " + pageable);
    System.out.println("接收到的 Filters: " + filters); // 这里会是空列表 []
    return Page.empty();
}