掌握Spring Boot异常处理技巧，让错误提示更优雅

2024-02-13 08:55:14

前言

在上一篇文章中，我们介绍了Spring Boot的全局结果集返回，它提供了一种优雅的返回后端数据的方式。然而，在实际开发中，我们不可避免地会遇到各种各样的异常情况。如果处理不当，这些异常可能会给用户带来糟糕的体验。

Spring Boot提供了强大的异常处理机制，我们可以通过它自定义异常处理、使用HTTP状态码表示错误，以及使用ControllerAdvice进行异常处理。通过这些技巧，我们可以让错误提示更加优雅，帮助开发人员更轻松地定位和解决问题。

自定义异常处理

Spring Boot允许我们自定义异常处理，以便为不同的异常情况提供不同的处理方式。我们可以通过在@ControllerAdvice注解的类中定义异常处理方法来实现自定义异常处理。

例如，我们可以定义一个名为GlobalExceptionHandler的类，并在其中定义一个处理NullPointerException异常的异常处理方法：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<String> handleNullPointerException(NullPointerException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("参数为空");
    }

}

当发生NullPointerException异常时，Spring Boot将调用handleNullPointerException()方法来处理异常。该方法将返回一个HTTP状态码为400（Bad Request）的ResponseEntity，并在ResponseEntity的body中包含错误信息"参数为空"。

使用HTTP状态码表示错误

HTTP状态码是一种表示HTTP请求结果的代码。它可以帮助我们快速了解请求是否成功，以及如果请求失败，失败的原因是什么。

Spring Boot允许我们使用HTTP状态码来表示错误。我们可以通过在@ExceptionHandler注解的方法中指定HTTP状态码来实现这一点。

例如，我们可以将handleNullPointerException()方法中的HTTP状态码修改为500（Internal Server Error）：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NullPointerException.class)
    public ResponseEntity<String> handleNullPointerException(NullPointerException ex) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("服务器内部错误");
    }

}

这样，当发生NullPointerException异常时，Spring Boot将返回一个HTTP状态码为500的ResponseEntity，并在ResponseEntity的body中包含错误信息"服务器内部错误"。

使用ControllerAdvice进行异常处理

ControllerAdvice是一种用于处理异常的注解。我们可以通过在类上添加@ControllerAdvice注解来定义一个ControllerAdvice。

ControllerAdvice可以处理任何类型的异常，并且它可以应用于整个应用程序或特定的控制器。

例如，我们可以定义一个名为GlobalControllerAdvice的ControllerAdvice，并将其应用于整个应用程序：

@ControllerAdvice
public class GlobalControllerAdvice {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception ex) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("服务器内部错误");
    }

}

这样，当应用程序中发生任何类型的异常时，Spring Boot将调用handleException()方法来处理异常。该方法将返回一个HTTP状态码为500的ResponseEntity，并在ResponseEntity的body中包含错误信息"服务器内部错误"。