Spring Boot 3.2与2.7列表参数验证机制差异及文档咨询

核心行为差异 #

• Spring Boot 2.7：要验证列表（或集合）内的对象，必须在控制器类上添加@Validated注解，否则参数上的@Valid不会触发集合内元素的校验逻辑。即便集合中存在不符合校验规则的对象，接口仍会返回200状态码，校验逻辑完全不生效。
• Spring Boot 3.2：无需在控制器类上添加@Validated，仅需在列表类型的请求体参数上标注@Valid，即可自动触发集合内每个对象的校验。校验失败时，接口会直接返回400状态码，符合预期的参数校验行为。

版本依赖的底层变化 #

这个差异源于Spring框架的版本升级：Spring Boot 3.2基于Spring 6.1，而Spring 6.1对@Valid注解处理集合类型参数的逻辑做了增强，原生支持集合内元素的递归校验，不再依赖Spring的@Validated扩展来触发这一行为。

代码示例 #

控制器代码 #

@RestController
// Spring Boot 2.7 必须添加此注解才能让集合校验生效：@Validated
public class HelloController {
    @GetMapping("/")
    public String hello() {
        return "Hello World!";
    }

    @PostMapping("/test")
    public String helloPost(@RequestBody @Valid List<HelloRequest> helloRequests) {
        return helloRequests.stream().map(HelloRequest::getName).collect(Collectors.joining(", "));
    }
}

请求体对象代码 #

public class HelloRequest {
    @Max(10)
    @NotNull
    private long id;

    @NotNull
    private String name;

    public HelloRequest() {
    }

    public Long getId() {
        return id;
    }

    public String getName() {
        return name;
    }
}

测试请求示例 #

[
    {
        "id": 12,
        "name": "d",
        "babyRequests": [
            {
                "id": 1
            },
            {
                "id": 1
            }
        ]
    }
]

相关文档说明 #

目前官方仅在Spring 6.1和Spring Boot 3.2的发布说明中提及“校验逻辑增强”，暂无单独的详细差异文档。核心变化在于Spring 6.1优化了与Jakarta Validation的集成，原生支持集合类型参数的元素校验，不再需要通过@Validated来扩展能力。

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