SpringBootGET和POST请求参数校验统一处理

本文介绍Spring Boot 2.7.14版本中GET和POST请求参数校验的统一处理方法。由于`@RequestParam`不支持JSR-303校验注解，导致GET请求参数校验失败时抛出`MissingServletRequestParameterException`，而非预期的校验异常。文章通过将GET请求参数封装到DTO对象，并结合自定义全局异常处理器，统一处理`MethodArgumentNotValidException`和`MissingServletRequestParameterException`，最终实现GET和POST请求参数校验结果格式的一致性，提升代码的可维护性和可读性，有效解决Spring Boot参数校验难题。

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 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响应，包含状态码。

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

理论要掌握，实操不能落！以上关于《SpringBootGET和POST请求参数校验统一处理》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！