SpringMVC异常处理句柄这些细节，你知道吗？

回顾

@Controller和@ControllerAdvice类可以使用@ExceptionHandler注解标注方法来处理控制器方法的异常，如下例所示：

局部异常处理

@Controller
public class SimpleController {

  // ...
  // 只能处理当前SimpleController中发生的异常
  @ExceptionHandler
  public ResponseEntity<String> handle(Exception ex) {
    // ...
  }

}

全局异常处理

@RestControllerAdvice
public class TestControllerAdvice {
  
  // 全局异常处理
  @ExceptionHandler
  public Object handle(Exception e) {
    return "我是全局异常： " + e.getMessage() ;
  }
  
}

指定能处理的异常类型

@ExceptionHandler({FileSystemException.class, RemoteException.class})
public ResponseEntity<String> handle(Exception ex) {
  // ...
}

在@ExceptionHandler中指明能够处理的异常类。

以上是回顾了SpringMVC异常处理的基本使用，通过@ExceptionHandler注解标注方法，在上面的方法中都接受的是异常类，那这方法可以接收什么样的参数及返回值呢？

异常句柄参数

@ExceptionHandler方法支持以下参数:

异常句柄返回值

@ExceptionHandler方法支持以下返回值:

REST API异常

REST服务的一个常见需求是在响应体中包含错误详细信息。Spring框架不会自动执行此操作，因为响应体中的错误细节表示是特定于应用程序的。但是，@RestController可以使用带有ResponseEntity返回值的@ExceptionHandler方法来设置响应的状态和主体。这样的方法也可以在@ControllerAdvice类中声明，以便全局应用它们。

在响应体中使用错误细节实现全局异常处理的应用程序应该考虑扩展ResponseEntityExceptionHandler，它为Spring MVC引发的异常提供处理，并提供自定义响应体的钩子。要使用它，可以创建ResponseEntityExceptionHandler的子类，用@ControllerAdvice注释它，重写必要的方法，并将其声明为Spring bean，如下：

@RestControllerAdvice
static class CustomResponseEntityExceptionHandler extends ResponseEntityExceptionHandler {

  @Override
  protected ResponseEntity<Object> handleExceptionInternal(Exception ex, Object body, HttpHeaders headers,HttpStatus status, WebRequest request) {
    System.out.println(">>>>>>>>>>> - body - " + body) ;
    System.out.println(">>>>>>>>>>> - headers - " + headers) ;
    System.out.println(">>>>>>>>>>> - status - " + status) ;
    return new ResponseEntity<>(ex.getMessage(), headers, status) ;
  }
    
}

ResponseEntityExceptionHandler类中内置了很多类型的异常处理

public abstract class ResponseEntityExceptionHandler {
  @ExceptionHandler({
    HttpRequestMethodNotSupportedException.class,
    HttpMediaTypeNotSupportedException.class,
    HttpMediaTypeNotAcceptableException.class,
    MissingPathVariableException.class,
    MissingServletRequestParameterException.class,
    ServletRequestBindingException.class,
    ConversionNotSupportedException.class,
    TypeMismatchException.class,
    HttpMessageNotReadableException.class,
    HttpMessageNotWritableException.class,
    MethodArgumentNotValidException.class,
    MissingServletRequestPartException.class,
    BindException.class,
    NoHandlerFoundException.class,
    AsyncRequestTimeoutException.class
  })
  @Nullable
  public final ResponseEntity<Object> handleException(Exception ex, WebRequest request) throws Exception {
    HttpHeaders headers = new HttpHeaders();

    if (ex instanceof HttpRequestMethodNotSupportedException) {
      HttpStatus status = HttpStatus.METHOD_NOT_ALLOWED;
      return handleHttpRequestMethodNotSupported((HttpRequestMethodNotSupportedException) ex, headers, status, request);
    }
    else if (ex instanceof HttpMediaTypeNotSupportedException) {
      HttpStatus status = HttpStatus.UNSUPPORTED_MEDIA_TYPE;
      return handleHttpMediaTypeNotSupported((HttpMediaTypeNotSupportedException) ex, headers, status, request);
    }
    // ...
    else {
      throw ex;
    }
  }
}