Spring Boot 2.x必填参数异常处理失效问题求助

我来帮你排查这个问题，你遇到的情况是因为**MissingServletRequestParameterException没有被正确处理并返回自定义响应体**，而且你的全局异常处理器配置有几个需要调整的地方：

问题根源 #

1. 当缺少@RequestParam必填参数时，Spring MVC抛出的是MissingServletRequestParameterException，这个异常属于Spring MVC的内置异常，需要在ResponseEntityExceptionHandler中重写对应的处理方法并返回自定义响应，而不是调用super（super的默认处理在你的配置下没有正确输出响应体）。
2. 你的@ExceptionHandler(Exception.class)虽然能捕获所有异常，但它的优先级低于ResponseEntityExceptionHandler中针对特定异常的处理方法，不过如果自定义处理方法没有正确返回响应，就会导致响应体为空。

修复步骤 #

1. 正确重写handleMissingServletRequestParameter方法 #

不要调用super，而是自己构造包含异常信息的响应体，比如：

@Override
protected ResponseEntity<Object> handleMissingServletRequestParameter(MissingServletRequestParameterException ex, 
                                                                      HttpHeaders headers, 
                                                                      HttpStatus status, 
                                                                      WebRequest request) {
    Map<String, Object> body = new LinkedHashMap<>();
    body.put("timestamp", LocalDateTime.now());
    body.put("status", status.value());
    body.put("message", String.format("必填参数 '%s' 缺失", ex.getParameterName()));
    body.put("parameterName", ex.getParameterName());
    
    return new ResponseEntity<>(body, headers, status);
}

2. 统一handleMethodArgumentNotValid的响应格式（针对@RequestBody校验） #

如果你的OIdLGroupIds类用了@Valid注解做参数校验，这个方法是处理校验失败的情况，建议和上面的异常响应格式保持一致，方便前端统一解析：

@Override
protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex,
                                                              HttpHeaders headers,
                                                              HttpStatus status,
                                                              WebRequest request) {
    Map<String, Object> body = new LinkedHashMap<>();
    body.put("timestamp", LocalDateTime.now());
    body.put("status", status.value());
    body.put("message", "请求参数校验失败");
    
    Set<String> errors = ex.getBindingResult()
            .getFieldErrors()
            .stream()
            .map(x -> String.format("%s: %s", x.getField(), x.getDefaultMessage()))
            .collect(Collectors.toSet());
    body.put("details", errors);
    
    return new ResponseEntity<>(body, headers, status);
}

3. 确保全局异常处理器被正确扫描 #

@RestControllerAdvice默认扫描当前包及其子包，如果你的控制器在其他包，可以指定basePackages明确扫描范围：

@RestControllerAdvice(basePackages = "com.yourproject.controller")
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {
    // ... 你的异常处理方法
}

4. 检查自定义响应类的序列化 #

如果你的ErrorResponse类没有正确的getter方法，或者没有被Spring的消息转换器（比如Jackson）正确序列化，也会导致响应体为空。可以用Lombok的@Data注解简化配置：

@Data
public class ErrorResponse {
    private String title;
    private List<String> details;
    
    public ErrorResponse(String title, List<String> details) {
        this.title = title;
        this.details = details;
    }
}

测试验证 #

现在当你访问/test时，如果缺少_id参数，应该会返回类似这样的响应：

{
    "timestamp": "2024-05-20T12:34:56.789",
    "status": 400,
    "message": "必填参数 '_id' 缺失",
    "parameterName": "_id"
}

这样就能解决你遇到的400响应体为空的问题了。

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