接口入参验证（@RequestParam\@Valid\@Validated\@RequestBody）

最新推荐文章于 2025-06-06 18:45:52 发布

原创最新推荐文章于 2025-06-06 18:45:52 发布 · 1.6w 阅读

23 ·

CC 4.0 BY-SA版权

本文深入解析了@RequestParam与@RequestBody在不同请求类型中的应用，详细介绍了如何使用@Valid和@Validated进行参数有效性检查，包括基本类型及实体对象的验证，并探讨了嵌套对象的验证策略。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

今天了解了下接口入参验证问题：

@RequestParam 适用于Get请求且content-type为application/x-www-form-urlencoded

@RequestBody 适用于post请求且content-type为非application/x-www-form-urlencoded类型，一般为application/json

(1)入参为@RequestParam或@RequestBody时，不用加@valid和@validated；

(2)入参为@NotNull时要在方法上加@valid或@validated，或者在类上加@Validated（@valid不能作用于类上），这样@NotNull才能起作用。

@Valid
@GetMapping("/exam-info")
public Boolean getInfo(@NotNull(message="examId不能为空")Long examId){......}

(3)当入参为实体对象时，需要在方法上加@Valid或@Validated或者在参数前加@Valid或@Validated，或者在类上加@Validated

@Valid
@GetMapping("/exam-info")
public Boolean getInfo(User user){......}


@GetMapping("/exam-info")
public Boolean getInfo(@Valid User user){......}

@Validated
@GetMapping("/exam-info")
public Boolean getInfo(User user){......}


@GetMapping("/exam-info")
public Boolean getInfo(@Validated User user){......}

public Class User{

    @NotNull（"id不能为空"）
    private Integer id;
    .
    .
    .
}

4.嵌套验证

@valid作用于属性上有嵌套验证作用，@validated不能作用于属性上,如下代码在User类的属性car上添加@valid注解，当传参id为空时会报错。

@GetMapping("/exam-info")
public Boolean getInfo(@Valid User user){.....}

@GetMapping("/exam-info")
public Boolean getInfo(@Validated User user){.....}

public class User{
  @Valid
  @NotNull("car不能为空")
  private Car car;

  ........

}

public class Car{
  
  @NotNull("id不能为空")
  private Integer id;

  ........

}