Spring Boot中GET和POST请求参数校验如何统一处理?

spring boot接口参数校验统一处理方案

本文探讨spring boot 2.7.14版本中GET和POST请求参数校验的差异,以及如何统一校验结果格式。 许多开发者在使用@RequestBody @Valid校验POST请求体时能够成功捕获MethodArgumentNotValidException,但GET请求使用@RequestParam @NotNull或@Validated注解却常常抛出MissingServletRequestParameterException,而非预期的校验失败信息。

这是因为@RequestParam本身不支持JSR-303校验注解(如@NotNull),它只负责将请求参数映射到方法参数。@Validated注解作用于方法参数对象,而单个long feedId并非对象。

为了解决这个问题并统一校验结果格式,我们采用以下方法:

首先,将GET请求参数封装到DTO对象中:

@GetMapping("/api") public String apiGet(@Valid ApiGetRequest request) {     // ... }  public class ApiGetRequest {     @NotNull     private Long feedId;      // getters and setters }

创建ApiGetRequest类,将feedId作为属性并添加@NotNull注解,利用Spring的校验机制进行非空校验。

其次,自定义全局异常处理器,统一处理校验异常:

@ControllerAdvice public class GlobalExceptionHandler {      @ExceptionHandler({MethodArgumentNotValidException.class, MissingServletRequestParameterException.class})     @ResponseBody     public ResponseEntity<String> handleValidationExceptions(Exception ex) {         String errorMessage;         if (ex instanceof MethodArgumentNotValidException) {             MethodArgumentNotValidException e = (MethodArgumentNotValidException) ex;             errorMessage = e.getBindingResult().getFieldError().getDefaultMessage();         } else if (ex instanceof MissingServletRequestParameterException) {             MissingServletRequestParameterException e = (MissingServletRequestParameterException) ex;             errorMessage = "校验失败:" + e.getParameterName() + ":不能为null";         } else {             errorMessage = "未知错误";         }         return ResponseEntity.badRequest().body(errorMessage);     } }

此全局异常处理器捕获MethodArgumentNotValidException和MissingServletRequestParameterException,并构建统一格式的错误信息。 使用ResponseEntity返回更规范的http响应,包含状态码。

Spring Boot中GET和POST请求参数校验如何统一处理?

通过此方案,无论POST请求的MethodArgumentNotValidException还是GET请求的MissingServletRequestParameterException,都能被统一处理,返回一致的错误信息格式,从而满足了开发者对校验结果格式的要求。 这提升了代码的可维护性和可读性。

© 版权声明
THE END
喜欢就支持一下吧
点赞7 分享