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({MethodArgu
mentNotValidException.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，都能被统一处理，返回一致的错误信息格式，从而满足了开发者对校验结果格式的要求。 这提升了代码的可维护性和可读性。